Location Rules

Location Rules let you teach PromoSync your house decoration defaults so they’re applied to imported products even when the supplier doesn’t ship decoration data. Each rule says: “for any product with these tags, the default locations and decoration methods are these.”

Why You Need These Rules

The PromoSync metafield that powers the storefront decoration block is psrestful.location_decorations. PromoSync populates that metafield from the supplier’s Media Content / Decoration data. When a supplier doesn’t publish that data, the metafield is empty and the decoration block on your product page has nothing to show.

This happens in two common situations:

1. Suppliers that ship blanks. SanMar, S&S, and most apparel suppliers don’t decorate themselves; they sell undecorated goods and leave decoration to you. Their PromoStandards feeds therefore don’t include location or decoration pricing data. PromoSync has nothing to write into the metafield.
2. Suppliers part-way through PromoStandards. Some suppliers are still rolling out PromoStandards services and have Product Data live but Media Content / Decoration not yet ready. The end result is the same: no decoration data to import.

Location Rules close that gap. You configure your own defaults once (for example, “every product tagged polo gets Front Chest with Embroidery”), and PromoSync applies them automatically.

When Rules Are Applied

A rule fires in two situations:

• At import time. When PromoSync imports a product that lacks supplier-provided decoration data, it checks the product’s tags against your active rules and stamps the matching rule’s locations and decorations onto the new product.
• When the Apply Default Location Decorations bulk action runs. Use this for products you’ve already imported, or to re-apply rules after editing them.

Finding the Settings Page

1. Open PromoSync from your Shopify admin.
2. Go to Shop Settings.
3. In the sidebar, click Location Rules.

The table lists every rule you’ve created, with columns for Name, Tags, Locations, Priority, Status, and Created. The pencil icon opens the rule for editing; the trash icon deletes it.

Creating a Rule

Click + Add Rule in the top right of the table to open the Create Location Decoration Rule dialog:

Click Create to save. The rule takes effect immediately for the next import and for the next run of the bulk action.

Writing the JSON

The Location decorations field is a JSON array. Each entry describes one location, with a nested list of decoration methods available at that location. A minimal one-location example:

[
  {
    "locationId": 53,
    "locationName": "Front",
    "decorationsIncluded": 1,
    "defaultLocation": true,
    "decorations": [
      {
        "decorationId": 3764,
        "decorationName": "LASER ENGRAVE",
        "maxImprintColors": 1,
        "default": true,
        "priceIncludes": false
      }
    ]
  }
]

The fields you’ll typically set per location:

And per decoration inside decorations:

The Show JSON example toggle in the dialog inserts a multi-location, multi-decoration sample you can copy and edit, which is usually easier than typing from scratch.

Tag and Priority Strategy

A few patterns that work well:

• One specific tag per rule. A single tag like embroidered-polo matched by one rule is easier to debug than overlapping tags across many rules.
• Generic at low priority, specific at high priority. Build a default-decoration rule at priority 0 that covers your fallback case, then layer specific rules (embroidered-polo, laser-engrave-possible) at higher priorities to override it.
• Use Shopify’s bulk-tag tools to apply your tags. You can filter products by vendor or collection in Shopify Admin and add a tag to all selected products at once, which makes large rollouts cheap.

Verifying a Rule Worked

After importing a product (or running Apply Default Location Decorations on it):

1. Open the product in Shopify Admin and scroll to its metafields.
2. Look for psrestful.location_decorations. It should match the JSON you defined in the rule, possibly merged with any decoration data the supplier did publish.
3. Or load the product page on your storefront and confirm the decoration block shows the expected locations and methods.

Editing or Disabling a Rule

In the Location Rules table:

• Click the pencil icon next to a rule to edit any field. Saves take effect for the next import and the next bulk-action run, but they do not retroactively update products that have already been imported. Run Apply Default Location Decorations on the affected products to apply the new rule.
• Uncheck Is active to pause a rule without deleting it. Inactive rules are skipped during matching.
• Click the trash icon to permanently delete a rule. Deleting a rule does not remove decoration data from products that previously matched it.

Related

• Apply Default Location Decorations: the bulk action that stamps these rules onto products you’ve already imported.
• Enrich Location Decorations: wires each decoration on a product to its Setup Fee and Run Charge product so checkout charges the imprint correctly. Run this after applying default decorations.
• Decoration Listings: creates the Setup Fee and Run Charge products that Enrich Location Decorations references.