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

# Onboarding wizard

> After install, Appfox reads your products and recent orders and recommends a first bundle you can approve in one click. Or use the manual wizard to pick products and a discount yourself.

When you first install Product Bundles by Appfox, the app recommends a first bundle built from your own store data. You approve it, activate it, and add the app block to your theme. If you'd rather choose everything yourself, the manual wizard is one click away.

## When onboarding appears

Onboarding shows automatically on your first visit after installing the app. If you've previously skipped or completed it, it won't appear again on its own. If you finished onboarding without creating a bundle, the dashboard shows a **Build my first bundle** banner that brings it back.

## Get a recommended bundle

**1. We read your store**

The app reads your active products (price, stock, collections and, if you set it, product cost) and your orders from the last 60 days. It does this in a few seconds. Nothing goes live while it works.

**2. Review the recommendation**

You see one recommended bundle with a live preview that uses your own products, and up to two other ideas. Each one says why it fits, with real numbers from your store. The suggestions can be quantity breaks on your best seller, a pair of products bought together, a mix and match box, or buy 2 get 1.

**3. Adjust and create**

Change the title or the discount if you like, then click **Create this bundle**. The bundle is saved as a **draft**, so it isn't on your store yet.

**4. Review and activate**

Check the preview, open the editor if you want to change more, then click **Activate bundle**.

**5. Go live**

Add the app block to your product page, as described in [Step 2: Go live](#step-2-go-live).

### How the discount is chosen

If you've set a **Cost per item** in Shopify for the products in a suggestion, the app picks a discount that keeps your margin healthy: about a third of your thinnest margin, rounded to 5%, between 5% and 25%. The card shows the margin you keep after the discount. Without costs, the discount defaults to 10% (15% for the deeper quantity break and for mix and match), and the card suggests setting product costs in Shopify.

### Stores with few orders

With fewer than 10 orders in the last 60 days, suggestions come from your catalog instead. These are labelled **Based on your catalog**. If the app can't read your catalog, or you have no active products, it opens the manual wizard.

### Choose manually instead

**Set up manually instead** and **None of these fit? Build your own** open the manual wizard described below. **Skip for now** takes you to the dashboard.

## Manual wizard

The manual wizard starts with a type picker. Classic stays in the wizard; other types open that type's editor.

### Step 1: Choose a type

Pick **Quantity breaks**, **Mix & match**, **Complete the bundle**, **Classic bundle**, **Buy X, get Y**, **Frequently bought together**, or **Bundle as a product**. Classic continues below. Other types open the editor with sensible defaults, and you can change the look later in **Style**.

### Step 2: Create a Classic bundle

Everything is on one screen:

**1. Pick 2 or more products**

Tick products from the list, or click **Browse all products** to search your whole catalog.

**2. Check the name**

The bundle name is filled in from the products you chose. Edit it if you like.

**3. Set your discount**

Choose a percentage (default 10%) or a fixed amount. Discounts are whole numbers. The wizard shows the bundle price and customer savings as you type.

Click **Create bundle**. The bundle is created as a Classic bundle and activated right away. Other bundle types (Mix & match, Buy X, get Y and more) are available from **Create a bundle** on the dashboard.

### Step 3: Go live

A bundle only appears on your store once the app block is added to your product page. Onboarding walks you through it:

1. Click **Add to my store**. The theme editor opens in a new tab with the block ready to add.
2. Click **Save** in the theme editor.
3. Come back to the wizard. It detects the block automatically and confirms that your bundle is live, with a link to view it on your store. If it does not confirm on its own, click **Check again**.

If you'd rather do this later, click **Finish later**. The dashboard Setup Guide keeps the **Add Bundles (product page)** task until it's done.

## Skip and return later

Not sure which bundle to start with? The last card on the type picker, **Not sure yet?**, has two options:

* **Explore the app first** closes the wizard and takes you to the dashboard. This does the same as **Skip for now**.
* **Close** (the X) does the same thing. You land on the dashboard, the wizard does not open again on its own, and the Setup Guide on the home page stays available so you can finish setup later.
* **Help me choose** opens a chat with our support team.

Below the card, a link reads **Chat with us and we'll build the first one with you.** Click it to open the chat with the question "Can you help me set up my first bundle?" already typed in. Nothing is sent until you press send. The same link appears on the **Bundles** page when you have no bundles yet, and once on the dashboard right after you skip the wizard.

Once you skip, the wizard won't appear again automatically. Create bundles from the dashboard by clicking **Create a bundle** on the home page or going to **Bundles** → **Create bundle**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.