GuidesBulk ActionsEnrich Location Decorations

Enrich Location Decorations

When a customer adds a decorated product to their cart, your store needs to also charge them for the decoration: a Setup Fee and a Run Charge, usually as separate line items at checkout.

Each of those fees is its own Shopify product behind the scenes (“PCNA, Embroidery, Setup Fee”, “PCNA, Embroidery, Run Charge”, etc.). They’re created once per supplier and reused across every product that offers that decoration.

The decoration data on a regular product is just a list of names (“Front Chest, Embroidery”). For checkout to actually charge the right fees, each entry in that list needs to point at the matching Setup Fee and Run Charge products. Enrich Location Decorations wires those pointers up.

You run it once after importing a batch of products that have decoration data, and any time the underlying Setup Fee or Run Charge products have been recreated.

When to Use It

  • You just imported products that have decoration data, and the storefront decoration block shows the decoration list but checkout doesn’t charge Setup Fee or Run Charge.
  • You ran Decoration Listings for a new supplier, and now you need to wire your existing products up to the new fee products.
  • Decoration data has changed on the supplier side (new decoration method added, old one renamed), and your products’ decoration list is out of sync with the fee products.
⚠️

Run this after Decoration Listings. If the Setup Fee and Run Charge products don’t exist yet, enrichment has nothing to point at.

Before You Run It

1. Create the Decoration Fee Products for Each Supplier

In PromoSync, open the dashboard and click the Decoration Listings card. Pick the supplier and click Create Decoration Products. This is a one-time step per supplier. It creates one Setup Fee product and one Run Charge product per decoration method the supplier offers.

You only need to repeat this when:

  • You add a new supplier
  • The supplier adds new decoration methods you want to support

See the full walkthrough in Decoration Listings.

2. Make Sure Your Products Have Decoration Data

The action only does work on products that already have a psrestful.location_decorations metafield. Products imported through PromoSync from a supplier that publishes decoration data will have this automatically. Products you’ve stamped with Apply Default Location Decorations will also have it.

Products without decoration data are skipped silently.

How to Run It

You have two ways to scope the job.

Option A, Run on Specific Products

  1. In Shopify Admin, go to Products.
  2. Tick the checkboxes next to the products you want to enrich.
  3. Click the ... button, then Apps > Bulk Product Sync.
  4. In the dropdown, pick Enrich Location Decorations.
  5. Click Submit.

Option B, Run on Every Product from a Supplier

This is the right choice after you’ve created decoration products for a supplier and want all of its products wired up. You don’t select anything in the product list: you pick the supplier, and PromoSync finds every product synced from it. Products without decoration data are skipped, so you don’t need to filter them out first.

Shopify’s bulk-action menu only appears once you tick products, so use one of these two instead.

From the PromoSync dashboard (Targeted Sync)

  1. In Shopify Admin, go to Apps > PromoSync.
  2. On the dashboard, find the Targeted Sync card and click Configure.
  3. In Action, pick Enrich Location Decorations.
  4. In Target, keep Supplier selected and pick the supplier in Supplier (PromoStandards).
  5. Click Preview count to see how many products match, then click Run.

From the Products list (Sync Products (Filter/All))

  1. In Shopify Admin, go to Products. Don’t select any products.
  2. Open More actions at the top of the list and choose Sync Products (Filter/All).
  3. In Select an action, pick Enrich Location Decorations.
  4. In Supplier (PromoStandards), pick the supplier. Leave Vendor name empty.
  5. Click Select All Matching, check the number of products found, and confirm.

“Supplier” here is the PromoStandards supplier the products were synced from (HIT, PCNA, SanMar…), not Shopify’s Vendor field, which usually holds the manufacturer.

Run one supplier at a time. Each run is a separate job with a 30-minute window before it has to break itself up, so smaller runs finish sooner, and each results email covers a single supplier, which makes unmatched decorations easier to trace.

What Happens Next

You’ll get an email titled “Location Decorations Enrichment Results”. It includes:

  • Products updated, how many products had their decoration list wired up to fee products.
  • Products skipped, products that didn’t need any changes (either no decoration data, or already wired correctly).
  • Decorations enriched, total number of individual decoration entries that got Setup Fee and Run Charge pointers added.
  • Decorations unmatched, decorations on your products that PromoSync couldn’t find a matching Setup Fee or Run Charge product for. This is the section to actually read. Each row tells you the product, the supplier, and the decoration name that didn’t match. Common cause: the matching Create Decorations step hasn’t been run for that supplier.

The email goes to the notification contacts you’ve set up in your shop settings.

How Matching Works

For each decoration on each product, PromoSync looks for a Setup Fee and Run Charge product in your store that satisfies two conditions:

  1. The fee product has the same supplier code as the product you’re enriching.
  2. The fee product’s handle starts with the same root as the decoration name (e.g. decoration “Laser Engrave” matches handles laser-engrave-setup-fee and laser-engrave-run-charge).

If both conditions match, the fee product’s ID is written into the decoration entry. If not, the decoration shows up in the “unmatched” section of the email.

Why Something Might Be Skipped or Unmatched

What the email or log showsWhat it meansWhat to do
Product skipped: “no psrestful.location_decorations metafield”The product has no decoration data to enrich.Either this product doesn’t offer decorations (correct), or it needs default decorations applied first. See Apply Default Location Decorations.
Product skipped: “location_decorations is not a list”The decoration data is malformed JSON (rare, usually from a hand-edited metafield).Open the product’s metafields in Shopify Admin and fix or clear the value.
Decoration unmatched: shows a decoration name and supplier codeNo Setup Fee or Run Charge product exists in your store for that supplier and decoration name combination.Open Decoration Listings for that supplier and run Create Decoration Products. Then run Enrich Location Decorations again.
Product updated 0 times even though selectedEvery decoration was already wired correctly, so there was nothing to change.No action needed.

Common Questions

Will this break the decoration data already on my products?

No. The action only adds Setup Fee and Run Charge pointers to existing decorations. Decoration names, locations, max imprint colors, and other data are left exactly as they were.

What if a decoration shows up as “unmatched” even though I ran Create Decorations?

Two common causes:

  1. The decoration name on the product doesn’t quite match the fee product’s handle (e.g. the supplier renamed “Embroidery” to “Embroidery 1-Color” after you created fees). Re-run Create Decoration Products for that supplier.
  2. The fee product was deleted by hand from Shopify. Re-run Create Decoration Products to recreate it.

Do I need to run this every time I import new products?

Yes, after each import of products with decoration data. The fastest workflow is: import a batch, then run Enrich Location Decorations on the same batch.

Do I need to run this for products with no decorations?

No. Those products are skipped automatically.

Does this change the visible product page in any way?

No. The enrichment is invisible to customers. They only notice the difference at checkout, when Setup Fee and Run Charge line items now appear correctly.

What if I’ve changed my decoration prices?

Edit the Setup Fee or Run Charge product price in Shopify Admin like any other product. You do not need to re-run this action, it only wires up which fee product to use, not the price on the fee.