Use the Lightup app

Learn the basics of working in Lightup

The Lightup app has three main areas:

  1. The left pane lists workspaces and app-level commands (such as Help or Logout).
  2. The top bar has tabs for working with data quality components.
  3. The main page takes up the rest of the app window and changes to reflect your choices on the left pane and the top bar.

The left pane: app settings and workspaces


Everyone can use the controls at the bottom of the left pane. Use the stack icon to collapse and expand the left pane. Use the gear icon to open a menu where you can:

  • Generate API credentials (for programmatic access to Lightup)
  • Open this Help content
  • Engage Lightup support
  • Log out
  • View the Lightup version number

Your app role establishes what you can do. Look at the top of the left pane to see which app role you have. For more information about app roles, see Learn about app roles.

  • โ€‹If you're an App Admin, you'll notice an Admin menu right under the app logo. If you have this role, you can create and manage Lightup user accounts, roles, and workspaces.
  • โ€‹If you're an App Editor, you won't find an Admin button, but you will notice the Add New Workspace button. As a member of this role, you can create and manage your workspaces, and can invite other Lightup app users to your workspaces.
  • If you don't have an Admin menu or an Add New Workspace button, you're an App Viewer. You can be invited to join a workspace. In the left pane, you'll see a list of workspaces where you're a member. Select the arrow at the right edge of a listed workspace to open a menu of commands for that workspace.

The top bar: navigation

The top bar offers a set of tabs you can select to focus on a specific quality monitoring process in a workspace.

The main page: get stuff done

After you pick a workspace and a tab, data quality tools appear in the main page. All data quality work you do in the Lightup app, you do in the main page, which displays data quality tools for the workspace you selected, based on the tab you chose. For example, if you chose the Metrics tab, data quality tools specific to metrics appear on the main page.

Working in Workspaces

A workspace is a virtual space that enables team collaboration on data quality control. Every datasource, metric, monitor, incident, and dashboard, is part of a workspace. A team can have many workspaces, providing a way to separately track data quality for different domains and to iterate on design.

โ€‹You do most of your data quality tasks inside a workspace. All the workspaces you can access appear in the left pane, listed under the app-level controls.


  • In multi-tenant mode, any user may be invited to join a workspace via email.
  • In single-tenant mode, only existing Lightup app users can be invited to a workspace.
  • You need at least the App Editor role to create workspaces.
  • A workspace may have one or more admins.
  • All of a workspace admins share responsibility for workspace management.

When a workspace is created, the workspace owner invites one or more existing Lightup app users to join the workspace as members. Only members of the workspace can access the workspace data. Each member also has a workspace role that determines what they can do in the workspace: admin, editor, viewer, and observer.

You can open any workspace you see listed in the left pane. Select a workspace to see what it contains and what actions you can perform there.


Workspace menus

Each workspace has a menu that you open with a drop-down arrow to the right of the workspace's name. These menu options apply to the whole workspace.

Most operations in Lightup take place within a workspace, where your workspace role governs what you can do. You can have different roles in different workspace. For example, you might be a workspace admin of one workspace, a workspace editor of another, and a workspace viewer of yet another. For more information, see Learn about workspace roles.

Note that your app role has no impact on your workspace roles. Your app role only dictates whether you can invite users to the Lightup Platform and whether you can create workspaces. Once you are a member of a workspace, your workspace role dictates what you can do in the workspace.