[New] Embedding a bundle builder on existing product pages

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.

Updated on: 02/06/2026