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

# Quickstart

> Install FoxSell Bundles Plus and find the bundle data needed for custom builds

Use this guide to get FoxSell Bundles Plus installed, create a first bundle, and locate the metafields and metaobjects that power partner-built storefront experiences.

## Install the app

<Steps>
  <Step title="Install FoxSell Bundles Plus">
    Install [FoxSell Bundles Plus from the Shopify App Store](https://apps.shopify.com/foxsell-bundles-plus), approve the requested permissions, and open the app from the Shopify admin.
  </Step>

  <Step title="Create a bundle">
    Use the app to create the bundle type your storefront needs. For custom PDPs, Mix and Match, Volume, and Cross Sell bundles expose the most commonly used storefront data through Shopify metafields and metaobjects.
  </Step>

  <Step title="Publish and verify the bundle product">
    Save the bundle, make sure the generated bundle product is available to the sales channel you are building for, and confirm the selected products and variants are published.
  </Step>

  <Step title="Read the bundle data">
    In your theme or headless storefront, read the bundle product metafields from the FoxSell app namespace and use the matching data structure page for the bundle type.
  </Step>
</Steps>

## Choose the right reference

<CardGroup cols={2}>
  <Card title="Fixed Bundles" icon="boxes-stacked" href="/data-structures/fixed-bundles">
    Predefined products sold together as one offer.
  </Card>

  <Card title="Mix and Match Bundles" icon="rectangles-mixed" href="/data-structures/mix-and-match-bundles">
    Customer-selected products, quantity options, add-ons, and template metafields.
  </Card>

  <Card title="Volume Bundles" icon="layer-group" href="/data-structures/volume-bundles">
    Quantity-based tiers and discount configuration.
  </Card>

  <Card title="Cross Sell Bundles" icon="arrows-cross" href="/data-structures/cross-sell-bundles">
    Related products shown alongside a main product.
  </Card>
</CardGroup>

## Storefront setup checklist

* Install the app on the merchant store and create the bundle in FoxSell.
* Confirm the generated bundle product is published to the storefront channel.
* Read bundle configuration from the bundle product metafields, not from hardcoded storefront data.
* Use the data structure page for the bundle type to map metafield values to your UI.
* When adding Mix and Match bundles to cart, send the FoxSell line item properties documented in the Storefront API examples.

## App namespace

FoxSell stores partner-facing bundle data in the app-owned namespace used throughout these docs:

```liquid theme={null}
{% liquid
  assign app_namespace = 'app--67872686081'
%}
```

For example, Mix and Match bundle data is available from the `dynamic_add_ons_bundle` metafield on the generated bundle product.

```liquid theme={null}
{% liquid
  assign dynamic_add_ons_bundle_config = product.metafields[app_namespace].dynamic_add_ons_bundle.value
%}
```

<Tip>
  Start with the bundle-specific data structure page before building a custom UI. Those pages include the metafield keys, nested field shapes, and cart properties expected by FoxSell.
</Tip>