URL Parameter Conditions

URL parameter conditions let you restrict when a tier is active based on URL parameters. Add conditions to any tier type — spend, quantity, product-in-cart, or custom trigger — so the tier only unlocks when the customer arrives via a specific link.

This is useful for campaign-specific promotions: create a unique URL, share it in an email or ad, and only customers who click that link see the gift offer.

How it works

You add one or more conditions to a tier, each with a key and value
When a customer visits your store, Omake checks the URL for matching parameters
If any condition matches (OR logic), the tier becomes active
Once matched, the condition is stored as a trigger in the browser for 14 days

For example, a condition with key campaign and value spring2026 matches the URL:

https://yourstore.com?campaign=spring2026

Adding conditions to a tier

Go to Your Omake page and create or edit a tier.

In the tier settings, find the **Conditions** section.

Click **Add condition**.

Enter the URL parameter key (e.g., `campaign`).

Enter the expected value (e.g., `spring2026`).

Save the tier.

You can add multiple conditions to the same tier. The tier activates if any condition matches (OR logic).

Conditions work alongside the tier's main trigger. A spend tier with a URL condition still requires the cart total to meet the threshold — the condition just controls whether the tier is visible at all.

Auto-add behavior

When a URL condition matches and the gift bag isn't in the cart, Omake can automatically add it. This is controlled by the Condition auto-add setting in Settings > Advanced.

On (default): Gift bag is added automatically when a URL condition matches
Off: You handle adding the gift bag yourself (via Omake.addOmake() or auto-add)

Condition auto-add is a separate setting from the main auto-add toggle. You can have auto-add off (headless mode) but condition auto-add on, so the gift bag only appears for campaign visitors.

Campaign URL examples

Email campaign:

https://yourstore.com/collections/all?campaign=spring_email

Tier condition: key = campaign, value = spring_email

Social media ad:

https://yourstore.com?utm_source=instagram&promo=gift

Tier condition: key = promo, value = gift

Influencer link:

https://yourstore.com?ref=influencer_jane

Tier condition: key = ref, value = influencer_jane

Multiple conditions (OR logic)

If a tier has multiple conditions, any single match activates the tier. For example:

Condition 1: key = source, value = email
Condition 2: key = source, value = sms

A customer arriving from ?source=email OR ?source=sms will both activate the tier.

Conditions are exact matches. The key and value must match exactly — no wildcards or partial matches.

Persistence

Once a URL condition matches, it's stored in the browser for 14 days. The customer doesn't need to keep the URL parameter in their address bar — the match is remembered across page navigations and return visits within that window.