# Publish on Your Storefront

This guide explains how to make a bundle visible to customers.

## Required: Theme Integration

Bundles need theme integration to render on the storefront. The setup depends on your bundle type.

### Build Your Own Bundle — Enable the App Embed

BYOB bundles use a Shopify app embed.

1. In Shopify, go to **Online Store > Themes**.
2. Click **Customize** on your current theme.
3. Open **App embeds**.
4. Turn on **Bundle Builder**.
5. Click **Save**.

You only need to enable this once per theme. After it is on, all BYOB bundles can render.

### Multi-Option Bundle — Add the App Block

MOB bundles use a Shopify app block that must be placed on a product template.

1. In Shopify, go to **Online Store > Themes**.
2. Click **Customize** on your current theme.
3. Navigate to a **product template**.
4. In the left sidebar, click **Add section** or find the app block area.
5. Add the **Multi-Option Bundle** app block.
6. Click **Save**.

If the app block is not added, the bundle will not appear on product pages even if the bundle is active.

## Choose How Bundles Display

Open **Settings > Bundle display** in the app.

You can choose:

| Display mode   | What customers see                                          | Recommended for                                           |
| -------------- | ----------------------------------------------------------- | --------------------------------------------------------- |
| Product page   | The bundle builder replaces the normal product page content | Most stores                                               |
| Dedicated page | The bundle opens on a standalone bundle page                | Stores that want a separate landing-page style experience |

Product page mode is recommended for most merchants because it keeps the bundle tied to the Shopify product page.

## Set Bundle Status

Open the bundle and choose the status:

* **Draft**: hidden from customers.
* **Unlisted**: visible by direct link for testing.
* **Active**: published for customers.

Use **Unlisted** first, test the full buying flow, then switch to **Active**.

## Preview the Bundle

From the dashboard, use the view action for a bundle. This opens the storefront preview or product URL when available.

Test these actions:

1. Open the bundle page.
2. Select products or options.
3. Confirm required steps behave correctly.
4. Add the bundle to cart.
5. Continue to checkout.
6. Confirm discounts apply as expected.

## Add the Bundle to Store Navigation

After launch, help customers find the bundle:

* Add the bundle link to your main menu.
* Feature it on the homepage.
* Add it to a collection page.
* Use it in email or SMS campaigns.
* Link it from product pages that pair well with the bundle.

## Publishing Checklist

Your bundle is ready when:

* The app embed is enabled (BYOB) or the app block is added (MOB).
* Bundle status is **Active** or **Unlisted**.
* Storefront preview loads correctly.
* Products, variants, and images are correct.
* Add to cart works.
* Checkout discounts are correct.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.elitebundleapp.com/customize-and-publish/publish-on-storefront.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.