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

1

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

The shopper clicks the “On Air” design in the ad carousel. Opened through the curated-first link, the collection starts with that exact design — only the order changes: nothing is hidden, nothing is removed.
  • 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.
2

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.

  1. In Shopify admin, go to Online Store → Themes and press Customize on your BuildMyPOD theme.
  2. Open Theme settings (the gear icon at the bottom of the left sidebar).
  3. Scroll to BMP: Curated first.
  4. Make sure Enable curated-first pinning is toggled on, then press Save.
Shopify theme editor — Theme settingsExample

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.

Enable curated-first pinning

Loads a small script on collection pages that only activates when the URL parameter below is present.

URL parameter name

first

The URL parameter that carries the product handle to pin, e.g. ?first=my-product.

Swap image to pinned variant

Swap the pinned card's image to the linked variant's image, when available.

Theme editor → Theme settings → “BMP: Curated first”. Both switches ship toggled on, and the parameter ships as “first”.
  • 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, first by 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.
3

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:

  1. In Ads Manager, open the ad (not the campaign or ad set) of your catalog campaign.
  2. In the Destination section, choose Manual destination and set Main destination to Website.
  3. In Website URL, put your collection URL — it is the fallback for any click that cannot use the deep link.
  4. Tick Override catalog website links.
  5. 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=

  6. Press + and pick product.url so the tag sits right after first=. Meta replaces it with the clicked product’s URL on every impression.
  7. Publish, then preview a few different products and click through — each one should land on the collection with itself first.
Meta Ads Manager — Catalog adExample
Destination
Advantage+ destinationSend people to your website or app depending on where they’re most likely to convert.
Manual destinationSend people to the destinations you specify.

Main destination

Website

Website URL *

https://tuned-in-tees.com/collections/best-sellers
Use a display link
Override catalog website links

Set catalog deep links

https://tuned-in-tees.com/collections/best-sellers?first=product.url

One setup covers the whole catalog — you never type a product into this field.

Meta Ads Manager, catalog ad, Destination section. With “Override catalog website links” ticked, every click follows the deep link: your collection URL ending in “?first=”, with the product.url tag right after it.
The theme accepts a full product URL as the parameter’s value — which is exactly what Meta sends. If the product URL carries a ?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.

  1. In Ads Manager, open the ad and find the Destination section, with Main destination set to Website.
  2. Paste your curated-first link into Website URL, question mark included.
  3. Keep your tracking in the ad’s Tracking section, under URL parameters. That box takes key=value pairs only — never start it with a ?. Meta joins them onto your link, so ?first= survives.
  4. Publish, then open the ad preview and click through to confirm the landing.
Meta Ads Manager — Single image adExample
Destination

Main destination

Website

Website URL *

https://tuned-in-tees.com/collections/best-sellers?first=vintage-mic-tee

URL parameters have been moved to Tracking so you can manage them in one place.

Use a display link
Tracking

URL parameters

utm_source=facebook&utm_medium=paid

Tracking only. Meta appends these for you, so never start this box with a “?”.

Meta Ads Manager, single image ad, Destination section. The whole link — “?first=” included — goes in Website URL. Tracking parameters live in the ad’s Tracking section and only ever take key=value pairs.
5

Test it

  1. Open your link in a private / incognito window. A window logged into your admin can behave differently from a shopper’s.
  2. The product from the ad should be the first card, top-left.
  3. Click it and confirm it opens the right product — and the right variant.
  4. Apply any filter or change the sort. The pin should disappear — that is by design, not a bug.
  5. Try it once on a phone, since that is where your ad traffic lands.
Testing with a product that already sits first in the collection? Pick a different one from further down the grid — otherwise you cannot tell the pin apart from the natural order.

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
Curated first: land your ad on the design that was clicked | BuildMyPOD