Advanced Settings

The Advanced Settings page is found at Settings > Advanced in the Omake app. These settings are intended for developers and advanced use cases. Most stores work perfectly with the defaults.

Auto-add gift bag

Default: ON

When enabled, Omake automatically adds the gift bag product to the cart on every page load. When disabled, the gift bag is not added automatically — you need to add it yourself using Omake.addOmake() from the JavaScript API, or let condition auto-add handle it.

Disable this for headless mode or custom integrations where you control when the gift bag appears.

Condition auto-add

Default: ON (only visible when auto-add is OFF)

When enabled, the gift bag is automatically added when a URL parameter condition matches. When disabled, URL condition matches are recorded but the gift bag isn't added.

This setting only appears when Auto-add is turned off — when auto-add is on, the gift bag is always added regardless.

Use this to create campaign-specific promotions: turn off auto-add, turn on condition auto-add, and the gift bag only appears for customers who arrive via your campaign URL.

Show widget

Default: ON

When enabled, the Omake progress widget renders in the cart. When disabled, the widget is hidden but the JS API and Cart Transform still work.

Disable this for headless mode where you build your own UI.

Custom CSS

Add CSS that is injected into the storefront alongside the Omake widget. Useful for fine-tuning widget appearance on specific themes.

Most themes work without custom CSS.

Custom JavaScript

Add JavaScript that runs after the omake:ready event fires. Your code has full access to the window.Omake API.

Useful for custom integrations, analytics tracking, or triggering events based on store-specific logic.

// Track when a gift is unlocked
const state = Omake.getState();
const unlocked = state.tiers.filter(t => t.unlocked).length;
if (unlocked > 0) {
  analytics.track('gift_unlocked', { count: unlocked });
}

Headless mode

To run Omake in headless mode (no visible UI, full API control):

Go to **Settings > Advanced**.

Turn off **Auto-add gift bag**.

Turn off **Show widget**.

Save.

With both toggles off, Omake is fully headless. The Cart Transform still runs (gifts are swapped at checkout), but nothing is visible on the storefront.

Use the JavaScript API to control everything:

document.addEventListener('omake:ready', async function() {
  // Add the gift bag when you're ready
  await Omake.addOmake();

  // Trigger custom events
  await Omake.trigger('vip_customer');

  // Read state to build your own UI
  const state = Omake.getState();
});

In headless mode, the gift bag won't appear in the cart until you call Omake.addOmake(). Make sure your integration handles this.