Working with Rulesets

A ruleset is a set of feed rules you maintain in one place and apply to as many catalogs as you like. Change it once, publish it, and every catalog using it picks up the change.

Updated November 6, 2026

A ruleset is a set of feed rules you write once and apply to as many catalogs as you like. Change a rule inside the ruleset, publish it, and every catalog using it picks up the change, so you never copy the same fix into ten catalogs by hand.

Rulesets live under Rulesets in the top navigation. A catalog's own rules stay on its Rules tab.

When to use a ruleset#

Use one when the same cleanup applies to more than one catalog:

  • You run several markets or stores whose feeds come from the same platform and need the same fixes.
  • You keep re-writing the same "strip HTML from descriptions, normalize availability, drop out-of-stock" rules on every new catalog.
  • You want one place to change a rule when a destination changes what it accepts.

If a fix only applies to one catalog, keep it on that catalog's Rules tab.

Create a ruleset#

  1. Open Rulesets in the top navigation.
  2. Choose + Create manually. The new ruleset opens. Name it at the top of the page, after what it does ("Nordics base cleanup", "Sale price rules") rather than after the catalog you built it for.
  3. Add rules the way you would on a catalog's Rules tab: conditions, then actions, including Process images. See Fixing your feed data with rules.
  4. Publish the ruleset.

You can also use Start from a preset, which opens a gallery of prepared rulesets. Picking one makes your own copy that you can change freely, and later changes to the preset never reach your copy.

Or describe what you need in the What should these rules do? box at the top of the page, such as "exclude products that are out of stock". Aimée creates the ruleset and opens it so you can review the rules before you publish.

Applying a ruleset to a catalog#

On the catalog's Rules tab, choose Apply ruleset and pick one. It becomes a card in the rule list, and position matters: the ruleset's rules run at that point in the catalog's order, so rules above it run first and rules below it run after.

The rule links to each ruleset it applies, so you can jump in and edit it.

Applying a ruleset to only some products#

An Apply ruleset action works like any other action. To run a ruleset only for one brand, say, give the rule it sits in conditions, and the ruleset runs only for the products that match.

Put Apply ruleset in the rule's "Otherwise…" branch to run a ruleset for the products the conditions don't match. That way one rule can apply one ruleset to the matching products and another to the rest. One rule can also apply several rulesets, which run in the order they appear, beside other actions such as Set field.

The count on the rule is how many products matched it, not how many the ruleset changed. The ruleset's own rules have their own counts, which you see when you preview the ruleset with a catalog.

See which rulesets a project uses#

A project lists its rulesets below its catalogs: on the Overview's Catalogs card, and in full on the project's Catalogs tab. Each one shows how many of the project's catalogs use it, its status light, and an Unpublished marker when it has changes waiting. Click one to open it.

The status light here shows problems in that project only, so a ruleset can look fine in one project and need attention in another. A ruleset appears in this list once the catalog applying it has been published.

Column names belong to the applying catalog#

A ruleset reads and writes the column names in your feed, and every catalog's feed names its columns its own way. One shop's feed calls it title, another's calls it productname.

When a column name differs, fix it on the catalog, not in the ruleset, with a Set field that copies the value across: set productname to {{title}}, and the ruleset works unchanged. To bridge them, add a Set field action before the Apply ruleset action, in the same rule or in a rule above. Renaming a column inside the ruleset to suit one catalog silently breaks it for every other catalog using it.

Renable warns you when a ruleset reads a column the catalog doesn't seem to have, and gives that same advice. Your rules still run, and a column created by a rule further up the list is fine, so treat the warning as a reason to check the name.

Publish the ruleset first#

Publishing a ruleset reprocesses every catalog using it, and the confirmation names those catalogs first.

When you've changed both a ruleset and a catalog, the order matters:

  1. Publish the ruleset.
  2. Then publish the catalog.

A catalog always uses the ruleset's last published rules. Publish the catalog first and it runs the ruleset's old rules until you publish the ruleset. A ruleset you built yourself does nothing until its first publish, while a preset copy or a duplicate starts with its rules already published. The catalog's rule card shows an Unpublished marker when the ruleset it applies has changes waiting.

Preview against a real catalog#

A ruleset has no feed of its own. Preview with catalog lists the catalogs using this ruleset. Pick one, and the rule previews and the product trace run against that catalog's real feed data.

The workspace also shows a compatibility table of the columns this ruleset reads, across the catalogs using it. It shows where a column is missing or bridged.

Duplicate a ruleset#

Duplicate makes your own copy of a ruleset, from the copy button in the ruleset workspace's header or from the menu on the ruleset's card on the Rulesets page. The copy includes unpublished changes, and in the copy they count as published, so a catalog you apply it to runs them straight away.

If you belong to more than one organization, the dialog also lets you duplicate the ruleset into another of your organizations, which is useful for reusing a proven set of rules across clients. Switch to that organization to find the copy.

Archive a ruleset#

Rulesets are archived, never deleted. Archiving hides a ruleset from the list and from the apply picker. Catalogs already using it keep working, and the confirmation names them. Turn on Show archived to find it again and unarchive it.

Or ask Aimée#

Ask in the chat, such as "apply the Nordics ruleset to this catalog". Before a publish she tells you which catalogs it will reprocess, and she follows the same publish-the-ruleset-first order.

Where to go next#