Some suppliers (especially apparel suppliers selling blanks) don’t tell you what kinds of decoration the product supports. So when you import a polo from one of those suppliers, the polo arrives in Shopify without any decoration data, and your storefront decoration block has nothing to show.
Apply Default Location Decorations fixes this. You teach PromoSync your house defaults (“for every embroidered polo we sell, the default decoration location is Front Chest and the method is Embroidery”), and this action stamps those defaults onto products that match.
The matching is by product tags. You tell PromoSync which tags a rule applies to, and any product carrying one of those tags gets the rule’s decoration defaults.
This action does not overwrite decoration data that’s already on a product. If the supplier already sent decoration info, or you’ve already applied defaults, this action only adds anything that’s missing, it never replaces what’s there.
In PromoSync, open Shop Settings and turn on Default Location Decorations. (If this is off, the action will run but won’t change anything.) Once it’s on, a new tab called Location Rules appears in the shop settings sidebar.
Open Shop Settings > Location Rules and click Add Rule. See the Location Rules settings page for the form screenshots, JSON field reference, and tag/priority strategy. The fields, in brief:
| Field | What it does |
|---|---|
| Name | A label for you. PromoSync never shows it to customers. |
| Tags | Comma-separated list of product tags this rule applies to. Matching is case-insensitive and exact (“polo” matches “Polo” but not “polo-shirt”). |
| Priority | If a product matches more than one rule, the higher-priority rule wins. Higher numbers win ties. |
| Is active | Uncheck to disable a rule without deleting it. |
| Location decorations | The decoration data itself, as a JSON list of locations and decorations. The form’s Show JSON example button pastes a working example you can edit. |
Save the rule. Repeat for each tag-and-decoration combination you want to support.
The rule only fires when a product’s tags include at least one tag from the rule. So if your rule’s tags are polo, embroidered, make sure your polo products are tagged with polo or embroidered.
You can add tags during import, edit them by hand in Shopify, or use Shopify’s bulk-tag tools.
... button, then Apps > Bulk Product Sync.The job runs in the background.
This action does not send an email summary. To verify it worked, open one of the products in Shopify Admin and scroll to its metafields. You should see psrestful.location_decorations populated with the rule’s data. Or just check your storefront: load the product page and confirm the decoration block shows the expected locations.
This is the part that confuses people, so a clear example.
Say the product already has this decoration data on it (from the supplier, or from a previous run):
And the matching rule says:
After running the action, the product will have:
The plain-English rules:
| What’s happening | What it means | What to do |
|---|---|---|
| The product’s tags don’t match any rule. | No rule fires, so there’s nothing to apply. | Check the product’s tags and confirm at least one matches a rule’s tag list. |
| You have rules, but Default Location Decorations is turned off in shop settings. | The action checks the toggle and silently does nothing when it’s off. | Turn the toggle on in Shop Settings. |
| The product is already complete. | Every location in the rule is already on the product. | No action needed, this is the expected outcome on re-runs. |
JSON, a list of locations, each with its own list of decorations. The rule form includes a working example you can copy and edit. The shape matches what the storefront decoration block expects to read.
Only one rule fires per product, the highest-priority active rule whose tags match. Ties are broken by which rule was created most recently.
Add a tag like all to every product (Shopify’s bulk-edit makes this fast) and put all in the rule’s tags. There is no built-in “apply to everything” option.
No. If the supplier already sent decoration data for a location, that data is kept as-is. The rule only fills in locations the supplier left out.
Some suppliers’ import flows can apply default rules automatically as part of the import. This action is what you run when you’ve already imported products and need to apply (or re-apply) the defaults after the fact.
This action is fast and usually run on a small batch right after creating or changing a rule. If you want to confirm it ran, open one of the affected products and check its decoration metafield.
Decoration data alone isn’t enough. Checkout needs each decoration to be wired to the matching Setup Fee and Run Charge products in your store. See Enrich Location Decorations.