> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digifist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Storefront setup

> Enable the Galantis Discount Flow theme app embed so free gifts are auto-added to the cart and customers see discount signals on your storefront.

Galantis Discount Flow does its pricing work at checkout through a Shopify discount Function — that part needs no theme changes at all. The storefront side is different: auto-adding free-gift items to the cart and showing customer-facing signals is handled by a theme app embed, and Shopify requires you to switch app embeds on yourself.

Enabling it takes under a minute in the theme editor, and there is no theme code to touch.

<Warning>
  Without the embed enabled, **Free gift auto-add and storefront signals do not work** — a Free gift campaign can't place the gift in the cart, and customers get no on-page cues. Price discounts (percentage, fixed amount, shipping, and so on) are still applied at checkout by the discount Function regardless.
</Warning>

## Enable the theme app embed

<Steps>
  <Step title="Open the theme editor">
    In your Shopify admin, go to **Online Store → Themes** and click **Customize** on your live theme.
  </Step>

  <Step title="Open App embeds">
    In the theme editor's left sidebar, select **App embeds**.
  </Step>

  <Step title="Turn on Galantis Discount Flow">
    Find the **Galantis Discount Flow** embed in the list and toggle it on. Adjust its settings if needed — each one is explained below.
  </Step>

  <Step title="Save the theme">
    Click **Save** in the theme editor. The embed is now live on your storefront.
  </Step>
</Steps>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/digifist/images/galantis/discount/getting-started/theme-app-embed.png" alt="The Galantis Discount Flow app embed toggled on in the Shopify theme editor" />
</Frame>

## Embed settings explained

<AccordionGroup>
  <Accordion title="Enable Galantis Discount Flow" icon="toggle-on">
    **Default: on.** The master switch for all storefront behavior. Turn it off to pause everything the embed does — free-gift auto-add and storefront signals — without uninstalling the app. Checkout pricing is unaffected either way.
  </Accordion>

  <Accordion title="Debug mode" icon="bug">
    **Default: off.** Intended for troubleshooting during setup. Leave it off in normal operation; switch it on only when you're investigating storefront behavior with support.
  </Accordion>

  <Accordion title="Auto-add free gifts" icon="gift">
    **Default: on.** When a customer's cart qualifies for a **Free gift** campaign, the embed automatically adds the gift item to the cart. Turn this off if you don't want gifts added automatically — but note that Free gift campaigns rely on this behavior to deliver the gift.
  </Accordion>

  <Accordion title="Show a notification when a free gift is added" icon="bell">
    **Default: on.** Displays a storefront notification the moment a free gift lands in the cart, so customers understand why a new item appeared. Turn it off for a silent auto-add.
  </Accordion>

  <Accordion title="Free gift notification text" icon="message">
    **Default: "Your free gift has been added to your cart 🎁".** The message shown by the notification above. Edit it to match your brand voice or language.
  </Accordion>
</AccordionGroup>

## When the embed is required — and when it isn't

| Scenario                                                                                                       | Embed required?                                   |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| Percentage off, Fixed amount off, Free shipping, Buy X get Y, Tiered discount, Bundle discount, Volume pricing | No — applied at checkout by the discount Function |
| **Free gift** campaigns (auto-adding the gift to the cart)                                                     | **Yes**                                           |
| Storefront signals and free-gift notifications                                                                 | **Yes**                                           |

<Tip>
  Even if you only run price discounts today, enable the embed anyway. It costs nothing, and your first Free gift campaign will work on day one instead of failing quietly because the embed was never switched on.
</Tip>

## Related guides

* [Your first campaign](/galantis/discount/getting-started/first-campaign)
* [How discounts apply at checkout](/galantis/discount/storefront/how-discounts-apply)
* [Rule Builder actions](/galantis/discount/rule-builder/actions)