Organization Settings

Create and apply organization labels

Labels are short, colored chips that you define once for the organization and attach to schemas. They show on the schema list and on each schema’s Info tab, which makes them a quick way to mark lifecycle, ownership, or data tier.

In the app: Settings › Organization Settings › Labels tab

[screenshot]
The Labels tab with a few labels, each showing its chip, usage count, and description.

Before you start

  • Creating, editing, and deleting labels needs the Admin role.
  • Applying labels to a schema needs Read/Write on that schema.

Create a label

  1. Click Add Label. The Add New Label dialog opens.
  2. Enter a Label Name (required, up to 100 characters).
  3. Optionally add a Description so others know when to use it.
  4. Pick a color from the swatches. There are 16, including bronze, silver, gold, and platinum for data tiers.
  5. Click Add Label.

The label appears in the list, and in the label pickers across the app, straight away.

What the Labels tab shows

Each row shows the label chip, how many schemas use it (“3 uses”), and its description (or “No description”). The edit and delete icons are on the right.

Edit a label

  1. Click the edit icon on the label’s row.
  2. Change the name, description, or color.
  3. Click Save Changes.

Every schema that uses the label picks up the change.

Delete a label

You can only delete a label that no schema uses. The delete icon is disabled on a label that’s in use, with the tooltip “Cannot delete label that is in use”. Remove it from those schemas first.

  1. Click the delete icon on the label’s row.
  2. Click Delete to confirm.

Deleting can’t be undone.

Apply labels to a schema

  1. Open the schema and go to its Info tab.
  2. In the LABELS card, click the edit (pencil) icon. The Edit Labels dialog opens.
  3. Click labels to select or clear them.
  4. Click Save.

You can also pick labels in the Labels field when you create a schema. If no labels exist yet, the dialog says so and points you to Organization Settings.

In the app: Data Model › Schemas › your schema › Info tab › LABELS

Note: Labels attach to schemas only. To tag tables, columns, ontology entities, or glossary terms, use custom attributes.

Pick labels that last

  • Lifecycle: Draft, Active, Deprecated.
  • Data tier: Bronze, Silver, Gold, Platinum, using the matching colors.
  • Ownership: Finance, Sales, Operations.

Keep the set small and agree on colors as a team. Save red for warnings such as “Deprecated”.

Tip: A label is for scanning. If you need a value you can filter on, report on, or require, use a custom attribute instead. See Attributes vs labels vs glossary terms.