# The Buy Box

{% embed url="<https://www.youtube.com/watch?v=lXwYIycrpIk>" %}

### Using the Buy Box

The Buy Box is a powerful feature in Pagedeck that lets you create shoppable product sections similar to Shopify product pages on your landing pages.&#x20;

{% hint style="info" %}
If your product offers subscription purchases, use the [Subscription Buy Box](/getting-started/buy-boxes-and-creating-offers/the-subscription-buy-box.md) instead.
{% endhint %}

### Adding a Buy Box to Your Page

1. Find the Buy Box in your sections list
2. Drag it to your desired position on the page
3. Open the Buy Box settings to begin customization

### Connecting Your Product

1. Go to your Shopify site and copy the product page URL
2. Paste the URL into the "Product Link Field" in Pagedeck
3. Click "Sync" to import all product data from Shopify
   * This automatically pulls in images, prices, variants, and other product details

### Customizing Product Options

After syncing your product, you can customize how it appears without affecting your Shopify store:

#### Variant Options

1. Open "Product Data" to access customization settings
2. Select an option (like "Scent")
3. Go to the "Layout" tab
4. Choose your preferred display style:
   * Radio buttons (default)
   * Drop-down menu
   * Swatches

#### Creating Swatches

When using swatches, you can:

* Choose a color using the built-in color picker
* Upload an existing swatch image for detailed previews

#### Editing Variants

For each product variant, you can:

* Change prices (useful for running discounts)
* Add or remove images that appear only on your landing page

### Checkout Configuration

#### URL Field

* Enter your base site URL to connect to your Shopify checkout
* If your checkout is hosted on a different domain or subdomain, choose that URL instead

#### Additional Checkout Options

* Add a discount code to apply automatically at checkout
* Include a variant ID as an add-on for free gifts
* Add URL parameters to tag orders with referral codes

### Customizing the Add to Cart Button

#### Button Text

* Change the default "Add to Cart" text (e.g., to "Secure Checkout")

#### Changing the Button Destination

Choose where customers go after clicking:

1. Pre-loaded checkout (default) - loads the correct variant and price
2. Cart page on Shopify
3. Custom URL - link to any page you want

#### Button Appearance

* Change the button color using your theme's primary or secondary colors

### Additional Buy Box Features

#### Product Details

* Add content to the details accordion section below the Buy Box

#### Image Display

* Change the orientation of the image carousel
* Position thumbnails on the side if preferred

#### Purchase Options

* Add a quantity selector
* Include a small message next to the price (e.g., "30 cents per load")
* Add an order note field for customizations or gift notes

#### Accordion Settings

* Choose whether the details accordion is open or closed by default

#### Section Settings

* Change the displayed currency
* Access theme adjustments
* Copy the section to another page


---

# 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.pagedeck.com/getting-started/buy-boxes-and-creating-offers/the-buy-box.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.
