Tutorials

Building rules in Super Tags

A Super Tags rule has two halves: WHEN (the conditions an item must match) and THEN (the tags to apply). Rules can tag with fixed values or with the item's own field values, and advanced rules can be written in Liquid. There is no limit to how many rules you can create on any plan. This tutorial covers each part of the rule editor with examples.

The rule editor at a glance

Super Tags rule editor with conditions, tags and live preview
The rule editor: conditions and tags on the left, a live preview of real items from your store on the right.

Name the rule, optionally put it in a group (groups become sections on the dashboard), build the WHEN and THEN, and watch the preview update as you type. Nothing touches your store until you save and a run happens.

What conditions can a rule use?

Conditions read the item's real fields. A few examples of what you can match on:

Rule type Example fields
Products Title, Vendor, Product Type, Price, Compare At Price, Total Inventory, Status, Collections, Description, Published At, Updated At, Sales Channel, Market Catalog, metafields
Variants SKU, Barcode, Price, Inventory Quantity, Option values (size, colour), parent product metafields
Orders Total Price, Total Discounts, Financial Status, Fulfillment Status, Shipping Country, Risk Level, Test Order?
Customers Number of Orders, Amount Spent, Last Order Created At, State, Marketing State, Tax Exempt?, Country

Operators include is equal to, contains, is one of, is greater / less than, is empty / not empty, and relative dates like -30 days so a rule can mean "published in the last 30 days" without ever editing it. Combine conditions with all (and) or any (or) matching. Metafield conditions pair a namespace and key, then match the value - so anything you store in metafields is taggable. Sales Channel and Market Catalog conditions match where a product is published, including Shopify Markets catalogs.

Starter templates

Every rule type ships with a library of ready-made recipes: pick one, preview the WHEN / THEN it will drop in, then apply and edit. They are the fastest way to learn what rules can do.

Super Tags starter template picker with WHEN and THEN recipe preview
The starter template picker: categories on the left, the recipe's WHEN / THEN preview on the right.

The full template list, for every rule type, is on the tutorials hub.

What are field-value tags?

Instead of a fixed tag, a rule can tag each item with the value of one of its own fields. One rule then produces a whole family of tags that stays in sync as your catalog changes. For example, a Vendor field tag with the prefix brand- tags every product brand-nike, brand-adidas, and so on.

Field-value tag transform editor showing prefix and filters with live preview
Shaping a field value into a tag: add a prefix, remove or replace text, then handleize. The pipeline preview shows the raw value turning into the final tag.

Each field tag can be shaped with a small pipeline: prepend or append text, remove or replace fragments, change case, and handleize (lowercase, hyphenated, tag-safe). With an example item inspected in the preview, you see the value flow through every step - Acme Widgets Co. becomes brand-acme-widgets.

Field-value tag pipeline preview showing raw value transforming into the final tag
The inline value flow under each field tag: raw value, each transform step, final tag - including the no-value case.

How do I preview a rule before it runs?

Pick a few of your real products, orders or customers in the live preview panel and you will see exactly which tags would be added or removed on each one, before you save. Conditions that match are highlighted per item, so a rule that does not fire is easy to debug: the failing condition is right there. What you preview is what gets applied.

Resource picker for choosing real store items to preview a rule against
The preview picker: search and filter your real store items, then inspect them against the rule.

Order and customer rules preview the same way, against real orders and customers:

Order rule editor with order examples in the live preview
An order rule with real orders in the preview panel.

How do variant rules work?

Variant rules evaluate each variant separately - SKU, options, price, inventory - and tag the parent product, since Shopify variants are not natively taggable. The preview has an "Inspecting variant" selector so you can step through a product's variants and see which ones match:

Variant rule editor with the inspecting-variant selector showing matches per variant
A variant rule: the in-stock M and XL variants match, the sold-out L does not.

How do I write advanced rules with Liquid?

Switch the recipe to Liquid mode (included on Pro and above) when the builder's conditions cannot express what you need: looping variants, arithmetic, or multi-branch logic. You get the full Shopify object for the item, the add_tag and remove_tag helpers, an inline linter and starter code templates.

{% for variant in product.variants %}
  {% if variant.inventory_quantity > 0 %}
    {% capture size_tag %}size-{{ variant.option1 | downcase }}{% endcapture %}
    {% add_tag size_tag %}
  {% endif %}
{% endfor %}

The complete guide, with a full example library, is on the Liquid mode reference.

What happens when I turn a rule off?

When you disable or delete a rule you choose whether to remove the tags it synced or keep them in place. If you remove them, Super Tags only clears the tags that rule added. Tags applied manually or by other rules are left untouched.

Can I move rules between stores?

Yes. Use Import / export on the dashboard to download your rules as JSON and import them into another store. Imported rules are added and nothing is overwritten.

Related tutorials