BuildMyPOD theme guide
Curated first
Your ad shows a design, the shopper clicks it, and your collection opens with that exact design as the first card. Set it up once in Meta Ads and it works for every product in your catalog.
About five minutes · Built into the BuildMyPOD theme — nothing to install
What it does
A catalog or carousel ad shows several designs at once. The shopper clicks one of them — and if the ad lands on a collection page, that design is usually buried somewhere in the grid. To the shopper, it looks like the wrong page.
Curated first closes that gap. The link carries the clicked product, and the theme moves it to the first position in the grid: the shopper sees the design they clicked, with the rest of the collection right behind it.
The ad — one carousel, many designs
Meta Ads, catalog carousel
Waveform
On Air
Retro Cassette
Plain collection link
/collections/best-sellers
Waveform
Retro Cassette
Vintage Mic
Talk Show
On Air
B-Side
Curated-first link
/collections/best-sellers?first=on-air
On Air
Retro Cassette
Vintage Mic
Talk Show
Waveform
B-Side
- Only the order changes. Nothing is hidden, removed or filtered out — the clicked design trades places with the first card, and everything in between stays where it was.
- Plain links are untouched. Without the parameter in the URL, the collection behaves exactly as it always has.
- The product does not have to be in the collection. If it is not there, the theme fetches it and shows it first anyway.
- Filters and sorting clear the pin. Once the shopper starts browsing on their own, the normal order returns.
Turn it on in your theme
Curated first ships switched on, so on a fresh BuildMyPOD store there is usually nothing to do here. It is still worth opening the panel once to confirm the parameter name, because your ads have to use the same one.
- In Shopify admin, go to Online Store → Themes and press Customize on your BuildMyPOD theme.
- Open Theme settings (the gear icon at the bottom of the left sidebar).
- Scroll to BMP: Curated first.
- Make sure Enable curated-first pinning is toggled on, then press Save.
BMP: Curated first
Pins one product to the front of a collection grid via a URL parameter, so an ad can land shoppers on a collection with the exact clicked product (and variant) already first. Does nothing unless the parameter is present in the URL.
Loads a small script on collection pages that only activates when the URL parameter below is present.
URL parameter name
The URL parameter that carries the product handle to pin, e.g. ?first=my-product.
Swap the pinned card's image to the linked variant's image, when available.
- Enable curated-first pinning — the master switch. Toggled off, every curated-first link behaves like a plain collection link.
- URL parameter name — the parameter your links carry,
firstby default. Change it only if something else on your store already uses that parameter, and then use your name everywhere. - Swap image to pinned variant — when the link names a variant, the pinned card shows that variant’s image instead of the product’s main image. Leave it on if your ads run per colour.
Set it up in Meta Ads
You do not build a link per product. In a catalog campaign, you change one field on the ad and Meta fills in the clicked product for you — every product in the catalog gets its own curated-first landing automatically.
Catalog campaigns (Advantage+ catalog ads)
By default, a catalog ad sends the click to the product page. Override the ad’s deep link and the click goes to your collection instead, with the clicked product carried along in the parameter:
- In Ads Manager, open the ad (not the campaign or ad set) of your catalog campaign.
- In the Destination section, choose Manual destination and set Main destination to Website.
- In Website URL, put your collection URL — it is the fallback for any click that cannot use the deep link.
- Tick Override catalog website links.
- In Set catalog deep links, type your collection URL with the parameter, up to the equals sign:
https://your-store.com/collections/collection-handle?first=
- Press + and pick
product.urlso the tag sits right afterfirst=. Meta replaces it with the clicked product’s URL on every impression. - Publish, then preview a few different products and click through — each one should land on the collection with itself first.
Main destination
Website URL *
Set catalog deep links
One setup covers the whole catalog — you never type a product into this field.
?variant=, the pinned card opens on that variant, so per-colour ads land right with no extra setup.Single image or video ads
One creative, one product: here Meta has nothing to fill in, so you paste a finished curated-first link (built in the next section) into the ad’s destination.
- In Ads Manager, open the ad and find the Destination section, with Main destination set to Website.
- Paste your curated-first link into Website URL, question mark included.
- Keep your tracking in the ad’s Tracking section, under URL parameters. That box takes
key=valuepairs only — never start it with a?. Meta joins them onto your link, so?first=survives. - Publish, then open the ad preview and click through to confirm the landing.
Main destination
Website URL *
URL parameters have been moved to Tracking so you can manage them in one place.
URL parameters
Tracking only. Meta appends these for you, so never start this box with a “?”.
Build a link by hand
Catalog campaigns never need a hand-built link — Meta builds it for you. Build one yourself for everything else: a single image ad, an email, an organic post, or a quick test. It is your normal collection URL with one parameter on the end — the handle of the product you want first.
https://your-store.com/collections/collection-handle?first=product-handle
A filled-in example
The store tuned-in-tees.com is running an ad for the product vintage-mic-tee and wants it to land on the best-sellers collection:
https://tuned-in-tees.com/collections/best-sellers?first=vintage-mic-tee
Where the handles come from
- Collection handle — open the collection on your storefront and take the part after
/collections/. - Product handle — open the product and take the part after
/products/. The handle alone is enough — no/products/prefix in the parameter. - Variant id (optional) — pick the variant on the product page and copy the number Shopify adds as
?variant=….
Build your link
Type the handles, or paste the collection and product URLs straight from your store — this reads the handles out of either.
Your live domain, or the .myshopify.com one.
The collection the ad should land on — the handle is enough.
The product in the ad creative — the handle, or paste its product URL.
Leave empty unless the ad shows one specific colour or size.
Add your store domain, the collection, the product to see your link.
Test it
- Open your link in a private / incognito window. A window logged into your admin can behave differently from a shopper’s.
- The product from the ad should be the first card, top-left.
- Click it and confirm it opens the right product — and the right variant.
- Apply any filter or change the sort. The pin should disappear — that is by design, not a bug.
- Try it once on a phone, since that is where your ad traffic lands.
Troubleshooting
The product is not first — the grid looks untouched.
Why: Curated-first pinning is switched off, or the parameter in your link is not the one the theme is watching for.
Fix: Theme settings → BMP: Curated first. Check the toggle is on and that “URL parameter name” matches the parameter in your link.
The setting is on, but still nothing happens.
Why: The product handle is wrong, or the product is not available on the Online Store sales channel.
Fix: Open your-store.com/products/<handle> in a private window. If that 404s or redirects, the handle in your link is wrong.
My catalog ad still lands on the product page.
Why: The ad’s deep link was not overridden, so the click follows the catalog’s default product URL.
Fix: Open the ad in Ads Manager and set the deep link to your collection URL ending in ?first=, with the Product URL tag after it.
The link opens the product page instead of the collection.
Why: The link points at a product URL, not a collection URL.
Fix: Curated first only runs on collection pages. The path must be /collections/… with the product in the parameter.
The pin disappears as soon as the shopper filters or sorts.
Why: That is by design.
Fix: The pin only controls the landing. Once the shopper filters or sorts, the normal order returns. Reload the link to see the pin again.
The pinned card shows the wrong colour or image.
Why: “Swap image to pinned variant” is off, or the variant in the link has no image of its own.
Fix: Turn the setting on and give the variant its own image in Shopify, or drop the variant id from the link.
Still stuck? Email support@wescale.ai with the link you built and the collection it should land on.
Not on a BuildMyPOD store yet?
Curated first is built into the BuildMyPOD theme, along with everything else your print-on-demand store needs on day one.
Build my free store