Gift With Purchase Storefront Settings

These settings control how Gift with Purchase (GWP) behaves on your storefront after a shopper qualifies for a gift. They live in the Shopify theme editor, not in the Atom offer builder. Open Online Store → Themes → Customize → Atom Commerce Connector, then scroll to Gift with Purchase. Offer setup (qualifiers, gifts, and whether shoppers choose a gift) is covered in the Gift With Purchase guide.

Most stores only need these settings

Leave Gift Auto-Add Behavior on Always add missing gifts if you want Atom to keep offering the gift whenever the cart still qualifies.
Switch to Respect shopper removal if you do not want Atom to re-add a gift the shopper removed, or re-open the gift picker after they dismiss it.
Optionally set Gift Removal Memory (minutes) and match Gift Picker Button colors to your brand.

Gift Auto-Add Behavior

This setting applies when the cart still qualifies for a gift but the shopper has declined it.

Option	What Atom does
Always add missing gifts (default)	Re-adds automatic gifts that are missing from the cart. Keeps re-opening the gift picker when the shopper still needs to choose a gift.
Respect shopper removal	Remembers the shopper’s decline for the Gift Removal Memory window. Does not re-add an automatic gift after the shopper removes it, and does not re-open the gift picker after the shopper closes it with X.

What counts as a decline

Shopper action	Always add missing gifts	Respect shopper removal
Removes an automatic gift from the cart	Gift is re-added on the next cart update	Gift stays out for the memory window
Closes the gift picker with X without finishing a selection	Picker can open again on the next cart update	Picker stays closed for the memory window
Selects enough gifts and the picker closes on its own	Normal	Normal — Atom does not treat this as a decline
Removes a chosen gift from the cart after using the picker	Picker can open again if gifts are still needed	Picker can open again if gifts are still needed

Removing a gift the shopper already chose from the picker is not the same as dismissing the picker. Only closing the picker with X (or removing an automatic gift) uses removal memory when Respect shopper removal is on.

Memory is stored in the browser tab (sessionStorage). It clears when the tab closes, and it expires after the memory minutes you configure.

Gift Removal Memory (minutes)

How long Atom remembers a decline when Gift Auto-Add Behavior is Respect shopper removal.

Detail	Value
Range	5 to 240 minutes
Default	60 minutes
Applies to	Automatic gift removals and gift picker dismissals (X)

If behavior is Always add missing gifts, this setting has no effect.

Gift picker button styling

These settings style the Add buttons inside the gift picker modal (the sheet shoppers use when the offer lets them choose a gift).

Setting	Default	Effect
Gift Picker Button Color	`#0c0b0a`	Background of Add buttons
Gift Picker Button Text Color	`#ffffff`	Label and loading spinner color
Gift Picker Button Border Radius	`4px` (0–40)	Corner roundness of Add buttons

Match these to your theme buttons so the picker feels native to your storefront.

What shoppers see in the picker

A modal titled with the offer name
Gift options in a carousel (up to two gift cards at a time on mobile)
Struck-through original price with FREE (or the gift discount) and an Add button
A selection counter such as 0 out of 1 selected
An X control to dismiss without choosing

Offer settings that affect the picker

These options are set on the GWP offer in Atom Commerce, not in the theme editor.

Offer setting	Effect on the storefront
Allow shopper to choose free gifts off	Atom adds eligible gifts automatically (no picker).
Allow shopper to choose free gifts on	Atom shows the gift picker when the shopper must choose a subset of gift options.
Number of gifts the shopper may choose	Cap on how many gifts they can add from the picker. If that number equals the number of gift options, Atom adds all of them and skips the picker.

Theme Gift Auto-Add Behavior and Gift Removal Memory still apply as described above for automatic gifts and picker dismissals.

Troubleshooting

Symptom	What to check
Gift keeps coming back after the shopper removes it	Set Gift Auto-Add Behavior to Respect shopper removal, and confirm Gift Removal Memory is long enough for your checkout flow.
Gift picker keeps reappearing after X	Same as above. Respect removal must be on; memory only applies after an X dismiss, not after a completed selection.
Picker never appears	Confirm the offer has Allow shopper to choose free gifts enabled, more gift options than the choose limit, and that the cart still qualifies.
Add buttons look wrong	Adjust the three Gift Picker Button color and radius settings.
Behavior resets after closing the tab	Expected — memory is per browser tab and does not persist across new sessions.

Get Started

Offers

Discount Limits

Discount Upsells