Order Labels for Magento 2 - User Guide

The Order Labels extension lets you attach color-coded labels to orders and show them as columns in the Magento order grid. This guide covers installation, creating label columns, creating labels (Static, Dynamic, and Predefined), styling them, setting auto-assignment rules and visibility, and viewing labels in the order grid.

php bin/magento cache:flush

After installation, the extension adds an Order Labels menu with three sections:

• Manage Labels: create and edit the labels themselves.
• Manage Columns: create the grid columns that hold labels.
• Labels Log: review label activity.

Before creating labels, set the extension's global options. Go to Stores > Configuration > Order Labels > General Settings and configure:

• Enable Module (store view): turn the entire Order Labels extension on or off.

• Enable Auto-Assignment (store view): set to Yes to let Dynamic (Rule-Based) labels assign themselves to matching orders. Set to No to pause all automatic assignment.

• Auto-Assign Cron Schedule (global): the cron expression that controls how often auto-assignment runs, for example 0 */6 * * * to run every 6 hours. Adjust it to assign labels more or less frequently.

• Enable Labels Log (store view): set to Yes to record label activity in the Labels Log.

Save the configuration, then flush the cache if prompted.

Auto-assignment depends on Magento cron. Make sure cron is running (php bin/magento cron:run), and note that Dynamic labels are applied on the schedule set in Auto-Assign Cron Schedule, not instantly.

1. Create Label Columns

Labels are displayed inside columns in the order grid, so create your columns first. Go to Order Labels > Manage Columns to see the list of existing columns, then click Add New Column.

In the Column Information section, configure:

• Column Name: the column label shown in the order grid (required).
• Column Code: a unique identifier for the column (required).
• Position: the order in which the column appears among other label columns. Lower numbers appear first.
• Allow Multiple Labels: set to Yes to let a single column hold more than one label on the same order.
• Filterable in Grid: set to Yes to allow filtering the order grid by this column's labels.
• Sortable in Grid: set to Yes to allow sorting the order grid by this column.
• Default Comment: an optional comment associated with the column.
• Enabled: turn the column on or off without deleting it.

Save the column. Repeat for each column you need, for example Priority, Payment Type, Customer Type, Shipping Type, or Promotions.

2. Create Labels

Go to Order Labels > Manage Labels to see existing labels, then click Add New Label.

2.1 General Information

• Label Name: the name of the label (required).
• Label Code: a unique identifier. Use lowercase letters, numbers, and underscores only (required).
• Label Type: choose one (required):
  • Static: applied manually to specific orders.
  • Dynamic (Rule-Based): assigned automatically when an order matches the conditions you set.
  • Predefined: a ready-made label for a common scenario.
• Predefined Type: choose the preset to use. This applies only when Label Type is set to Predefined.
• Assign to Column: select which column this label appears in, or leave as No Column.
• Priority: a number used when multiple labels compete for the same column. Lower number means higher priority.
• Enabled: turn the label on or off.

2.2. Appearance

Style how the label looks in the order grid:

• Display Type: choose how the label renders: Image Only, Text Only, Image and Text, or Text and Image.
• Background Color: set the label's background color with the color picker or a hex value.
• Text Color: set the label's text color with the color picker or a hex value.
• Icon Image: upload an icon for the label. Allowed file types are PNG, JPG, GIF, and SVG, up to 2MB.
• Default Note / Comment: text that is pre-filled when this label is manually assigned to an order.

2.3. Auto-Assignment

• Auto-Remove When Conditions No Longer Match: set to Yes to clear the label automatically once an order no longer matches its conditions. This applies only to Dynamic (Rule-Based) labels.

2.4. Visibility Restrictions

• Store Views: select the store views where this label applies. Leave empty to apply to all store views.
• Customer Groups: select the customer groups this label applies to, such as General, NOT LOGGED IN, Retailer, or Wholesale. Leave empty to apply to all customer groups.

2.5 Conditions (for Dynamic labels)

For a Dynamic (Rule-Based) label, define when it should be applied in the Conditions section. Under Apply Label If, choose whether ALL or ANY of the conditions must be true, then add conditions using the plus icon, for example "Status is Complete". Remove a condition with the red icon.

Save the label. Dynamic labels are then applied automatically to matching orders, Predefined labels follow their preset behavior, and Static labels are ready to assign manually.

3. Predefined Label Types

The extension ships with predefined labels for common scenarios, including:

• First Time Customer
• Repeat Customer
• Partially Shipped
• Partially Invoiced
• Back Order
• High Value Order
• Cash on Delivery
• International

Select the one you need from the Predefined Type dropdown when Label Type is set to Predefined.

4. Labels in the Order Grid

Once labels and columns are set up, open Sales > Orders. Each label column you created appears in the grid, and orders show their assigned labels in those columns. If a column is filterable or sortable, you can filter and sort the order grid by its labels to segment orders quickly.

5. Labels Log

Go to Order Labels > Labels Log to review the history of label activity across your orders.