Itsy Docs
Data

Labels

Organize and track trips and orders with color-coded labels that include revenue attribution on the dashboard.

Labels are named, color-coded markers you attach to trips and orders to organize, filter, and track revenue by category. Each label has its own management page entry with a color, slug, and description, plus built-in revenue tracking on the dashboard. Use labels for cross-cutting classifications like "premium", "summer-2026", or "corporate".

How It Works

You create labels in the Data > Labels management page, assigning each a name, slug, color, and optional description. Once created, labels can be attached to trips (from the trip's Settings tab) and to orders (from the order's Overview tab). The dashboard turnover cards then display a color-coded bar showing how revenue breaks down across your labels.

Key Concepts

Label Properties

PropertyDescription
NameThe display name for the label
SlugA URL-friendly identifier, useful for API integrations and external references
ColorA color used for visual indicators in lists and on the dashboard turnover bar
DescriptionAn optional note explaining what the label represents
ActiveWhether the label appears in selection dropdowns

Where Labels Can Be Applied

EntityWhere to assign
TripsSettings tab on a trip detail page
OrdersOverview tab on an order detail page

Filtering by Labels

The trips list includes a labels filter. When you select one or more labels, the list shows trips that match any of the selected labels.

Revenue Tracking

The dashboard turnover cards (Last Week, Last Month, Last Year, Total) each display a thin color-coded bar beneath the amount. Each segment of the bar represents a label, sized proportionally to that label's share of turnover for the period. Hover over a segment to see the label name and amount. This gives you an at-a-glance view of which categories drive your revenue.

Common Tasks

Creating a Label

  1. Navigate to Data > Labels
  2. Click Add
  3. Enter a Name (e.g., "Premium")
  4. Enter a Slug (e.g., "premium")
  5. Choose a Color from the color picker
  6. Optionally add a Description
  7. Toggle Active on
  8. Click Save

Editing a Label

  1. Go to Data > Labels
  2. Click the label name or use the action menu and select Edit Details
  3. Update any fields
  4. Click Save

Deleting a Label

  1. Go to Data > Labels
  2. Open the action menu on the label row
  3. Select Delete
  4. Confirm the deletion

Deleting a label removes it from all trips and orders it was assigned to.

Assigning Labels to a Trip

  1. Open a trip and go to the Settings tab
  2. Find the Labels selector
  3. Select one or more labels
  4. Save the trip settings

Assigning Labels to an Order

  1. Open an order and go to the Overview tab
  2. Find the Labels selector below the order details
  3. Select or deselect labels — changes save automatically

Filtering Trips by Labels

  1. Go to the Trips list
  2. Open the filter panel
  3. Select one or more labels from the labels filter
  4. The list updates to show only trips with any of the selected labels

How It Connects

  • Trips — Labels are assigned to trips for organization and filtering.
  • Orders — Labels are assigned to orders for tracking and revenue attribution.
  • Dashboard — The turnover cards display a color-coded breakdown of revenue by label.
  • Workspace API — External integrations can reference labels through the API.

On this page