Shipment Labels

Goal #

Tag shipments with your own color-coded categories (priority, customer, vessel, whatever your workflow needs) and filter by them afterwards.

Before you start #

• Any role except Viewer can create and apply labels. Viewers can see them but not change them.
• Admin or Owner role to rename, recolor or delete a label. See Managing labels.
• A naming convention, ideally. Labels are organization-wide and names are unique per organization (case-insensitive), so agreeing on them early avoids a list of near-duplicates.

Adding a Label to a Shipment #

On any shipment page, you’ll see the label area below the shipment header:

1. Click the + Add label button
2. Start typing to filter existing labels, or enter a new name
3. To use an existing label, click it from the suggestions list
4. To create a new label, type the name and pick a color from the palette, then click Create label

The label appears immediately on the shipment — no page reload needed.

Removing a Label #

Click the × on any label chip to remove it from the shipment. This only removes the association — the label itself remains available for other shipments. To delete a label altogether, see Managing labels.

Color Palette #

Labels come in 10 colors:

You choose the color when creating a label, and an admin can change it later (see Managing labels). It applies everywhere that label appears.

Managing labels #

Admins and owners keep the label list tidy under Shipments → Labels in Organization Settings. The page lists every label with the number of shipments that carry it. For each label you can:

• Edit it, to rename it or pick another color from the palette. The change shows on every shipment that has the label. Names must still be unique.
• Delete it. A confirmation shows how many shipments will lose the label, and deleting can’t be undone. The shipments themselves are not affected.

Renames, color changes and deletions appear on the organization’s activity log.

Bulk Labeling #

You can add a label to multiple shipments at once from the shipments list:

1. Select the shipments you want to label using the checkboxes
2. Use the Add label bulk action
3. Choose an existing label or create a new one

This is useful for tagging a batch of shipments that have something in common, such as the same vessel, week, or customer.

Tips #

• Labels are organization-wide — all members can see and use them
• Label names are unique per organization (case-insensitive)
• A shipment can have multiple labels
• Labels persist until removed from the shipment or deleted by an admin — they won’t disappear when shipment status changes