> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://easybundles-help.skailama.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# [New] Embedding a bundle builder on existing product pages

${youtube}[](rRHKM0HVpL0)

This documentation defines the process and backend logic for embedding the Bundle Builder widget directly onto storefront product pages. It covers widget activation, conditional display routing, content customization, and custom block positioning within the theme editor.

**Navigation & Activation**
1. **IF** the user intends to embed the builder, **THEN** they must navigate to the **Publish** section.
2. The user must click on **Product page embed**.
3. **IF** the **Bundle widget for product pages** toggle is switched to the ON position, **THEN** the system activates the embed configuration settings.

**Display Routing Rules** Once activated, the system requires a display targeting rule to determine where the widget renders. The user must select one of the following logic paths:
* **Path A (All Products):** **IF** selected, **THEN** the widget will render on the product pages of *every* individual product that is included in the configured bundle.
* **Path B (Specific Products):** **IF** selected, **THEN** the widget will only render on explicitly selected product pages.
* **Path C (Specific Collections):** **IF** selected, **THEN** the widget will render on the product pages of any item belonging to the explicitly selected collections.

**Widget Customization & Behavior**
* **Text Overrides:** The system accepts custom string inputs for the widget's **Title** and **Subtitle**.
* **Auto-Add Logic:** **IF** the user enables the setting to "auto add the product the customer is browsing", **THEN** the system will automatically inject the current product being viewed into the customer's active bundle state upon page load.

**Custom Positioning**
* **IF** the user wants to dictate the exact physical location of the widget on the page, **THEN** they must click the **Place block** button.
* **Action:** Clicking **Place block** triggers a redirect, opening the store's **Theme Editor**.
* **Action:** Inside the Theme Editor, the user modifies the custom position of the builder block within the page template.

**Publishing Status**
* **IF** the configuration is complete, **THEN** the user must click **Save** to commit the settings to the database.
* **IF** the user completes front-end verification AND clicks **Confirm**, **THEN** the bundle status changes to "Live" and becomes visible to storefront customers based on the configured Display Routing Rules.

## Constraints & Edge Cases
* **Publishing Dependency:** The bundle builder is **NOT** live on the storefront simply by clicking **Save**. The user must explicitly execute the **Confirm** action after saving and verifying the setup for the widget to be published.
* **Theme Editor Requirement:** The exact placement of the widget cannot be defined within the app's native UI; it strictly requires a redirect to the Shopify Theme Editor via the **Place block** button.