Skip to content

Administrator Guide

This guide describes day-to-day administration of IntroVox. For installation, see the Installation Guide.

IntroVox admin interface

Overview

IntroVox is an interactive onboarding wizard that helps new Nextcloud users discover key features through a guided tour. As an administrator, you control:

  • Global wizard availability — turn the tour on or off for everyone
  • Language support — which languages are available, with per-language configuration
  • Step management — add, edit, delete, reorder, and enable/disable individual steps
  • Group-based visibility — restrict specific steps to certain user groups (role-based onboarding)
  • User overrides — force-show the tour to all users, even those who disabled it

Accessing Administrator Settings

  1. Click your user avatar in the top right
  2. Select Settings (⚙️)
  3. Scroll down the left sidebar to Administration
  4. Click IntroVox

You're now on the IntroVox administration page.

Admin Interface Layout

The admin interface consists of three main sections:

1. Global Settings

  • Enable wizard for all users — master on/off toggle (Settings)
  • Available languages — checkboxes to enable/disable specific languages (Language Management)
  • Show wizard to all users — force-show button that clears all user preferences

2. Language Selector

  • Dropdown showing only enabled languages
  • Switches the step list to the chosen language's configuration

3. Step Management

  • Add step — create new wizard steps
  • Edit / Delete — modify or remove existing steps
  • Drag handle — reorder steps
  • Enable/disable toggle — temporarily hide steps without deleting
  • Export / Import — share configurations as JSON (Import/Export)
  • Reset to default — restore factory defaults for the selected language
  • Save changes — persist all modifications

See Managing Wizard Steps for details.

End User Experience

Automatic Start

When the wizard is enabled and the user's language is enabled:

  • New users see the wizard automatically on first login
  • The wizard starts on the dashboard page
  • Users can close the wizard anytime with ✕ or Skip and don't show again

The wizard automatically starts for users with any enabled language — IntroVox detects the user's Nextcloud language setting and shows steps in that language.

Manual Start

Users can restart the wizard from Personal Settings → IntroVox → Restart tour now, then refresh the page.

Behavior When Wizard or Language Is Disabled

If you disable the wizard globally or disable a user's language:

  • Users do not see the wizard automatically
  • In their personal settings they see a message:
  • Globally disabled: "The introduction tour is currently disabled by your administrator."
  • Language disabled: "The introduction tour is not available in your language."
  • They cannot start the wizard manually

Force-Showing the Wizard

The Show wizard to all users button resets the wizard for all users, including:

  • Users who already completed the wizard
  • Users who permanently disabled it in personal settings

Use this when:

  • A major Nextcloud upgrade adds features worth highlighting
  • You significantly updated wizard content
  • An important company announcement needs broad visibility

Warning: This overrides all user preferences. Users who explicitly opted out will see the wizard on their next login.

Next Steps