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

# Linking Shopify Products

> Link a Shopify product to your landing page to enable dynamic product data in product sections.

Linking a Shopify product to your EcomWize page allows product sections to display real product data -- prices, variants, images, descriptions, and more. This is essential for creating product-focused landing pages that stay in sync with your Shopify catalog.

## Why Link a Product

When a product is linked to your page:

* **Product sections** display real product data (title, price, images, variants)
* **AI content generation** uses product details to create more relevant copy
* **Publishing as a product template** requires a linked product
* **Dynamic pricing** shows actual prices and compare-at prices from Shopify
* **Variant selection** shows real product variants (size, color, etc.)
* **Selling plans** display subscription options if configured in Shopify

<Note>
  Linking a product is optional for pages that do not use product sections. If your page is purely informational (listicles, advertorial, brand story, FAQs...), you can skip this step.
</Note>

## Linking a Product

You can link a product at two points: during page creation or later in page settings.

### During Page Creation

<Steps>
  <Step title="Open the prompt bar">
    From the homepage, click the prompt bar to start creating a new page.
  </Step>

  <Step title="Select a product">
    Use the product selector to search for and select a product from your connected Shopify store. The product's title and image will appear as the selected product.
  </Step>

  <Step title="Continue creating your page">
    Finish setting up your page. The product data will be available in all product sections you add.
  </Step>
</Steps>

### From Page Settings

<Steps>
  <Step title="Open the builder">
    Open the page you want to link a product to in the builder.
  </Step>

  <Step title="Open Page Settings">
    Click the settings icon in the builder toolbar to open Page Settings.
  </Step>

  <Step title="Find the Product section">
    Scroll to the Product section in the settings panel.
  </Step>

  <Step title="Search and select">
    Use the product search dropdown to find and select your product. Products are loaded from your connected Shopify store.
  </Step>

  <Step title="Save">
    Save your page settings. The product data is now linked and available throughout the page.
  </Step>
</Steps>

## What Product Data Is Fetched

When you link a product, EcomWize fetches the following data from Shopify:

| Data Field        | Description                                                 |
| ----------------- | ----------------------------------------------------------- |
| **Title**         | The product name as set in Shopify                          |
| **Description**   | The full product description (HTML)                         |
| **Images**        | All product images, including variant-specific images       |
| **Variants**      | All product variants with their options (size, color, etc.) |
| **Prices**        | Current price and compare-at price for each variant         |
| **Selling plans** | Subscription/recurring purchase plans if configured         |
| **Vendor**        | The product vendor/brand name                               |
| **Product type**  | The product category/type                                   |
| **Tags**          | All product tags                                            |
| **Handle**        | The URL-friendly product slug                               |

<Tip>
  Product data is stored with your page so it is available even when offline or if the Shopify store is temporarily unreachable. The data is refreshed when you re-publish the page.
</Tip>

## How Product Data Updates

Product data in EcomWize reflects what was fetched from Shopify at the time of linking or last refresh. Here is how updates work:

* **On linking** -- The latest product data is fetched from Shopify and stored with the page.
* **On publishing** -- Product data is re-fetched from Shopify to ensure the published page has current prices, variants, and images.
* **Manual refresh** -- You can re-fetch product data by re-selecting the product in page settings.

<Warning>
  If you change a product's price, add variants, or update images in Shopify, those changes will not appear automatically on your EcomWize page until you re-publish or re-link the product.
</Warning>

## Changing the Linked Product

To switch to a different product:

1. Open Page Settings in the builder
2. Click the product dropdown
3. Search for and select the new product
4. Save your settings

The new product's data will replace the previous product's data throughout all product sections on the page.

## Using Product Data in Sections

Once a product is linked, product sections can display dynamic data:

* **Product hero sections** -- Show the product title, description, and featured image
* **Product detail sections** -- Display variant selectors, pricing, and add-to-cart buttons
* **Selling plan sections** -- Show subscription options and pricing tiers
* **Image galleries** -- Display all product images from Shopify

Product sections are available in the Sections Panel under the "Product" category. See [Product Sections](/sections/product-sections) for more details.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I link multiple products to one page?">
    Each page can have one linked product. If you need to feature multiple products, create separate pages for each product or use non-product sections with manually entered content.
  </Accordion>

  <Accordion title="What happens to product sections if I unlink the product?">
    Product sections will be empty until you select a new product.
  </Accordion>

  <Accordion title="Can I link a product that is in draft status on Shopify?">
    Yes, you can link draft products. However, if you publish the page as a product template, the product page may not be publicly accessible until the product is also set to active in Shopify.
  </Accordion>
</AccordionGroup>