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

# Connect your store

## Prerequisites for BigCommerce Integration

To prepare your BigCommerce store for Experro Discovery, make sure you have:

1. **BigCommerce Control Panel Admin Access**\
   Administrator rights to the BigCommerce control panel, including the ability to create and manage Store “API Accounts.”

2. **API Account Creation Capability**\
   Access to **Settings** → **Store Level API Accounts** to create a V2/V3 API token with the required OAuth scopes.

3. **Desired API Scopes Defined**\
   Identify the OAuth permissions you need (e.g., Store Catalog, Customers, Orders, Themes, Content) before token creation. (These details will also be provided in this integration guide.)

4. **Downloaded Credentials File**\
   Ability to securely download and preserve the `.txt` file containing your **access token**, **client ID**, **client secret**, and **API path**—this file cannot be retrieved again.

5. **Experro Admin Panel Access**\
   A Workspace Admin role in Experro to navigate to **Workspace Settings** → **Store Integration**, select BigCommerce, and enter the credentials.

6. **Store Hash Identification**\
   Knowledge of the BigCommerce Store Hash (from the API path URL: `https://api.bigcommerce.com/stores/<storehash>/v3`) for input during Experro configuration.

## Connect to the Store

Connecting to your store consists of two main steps:

* **Create an API Token in BigCommerce**
* **Configure the Integration in the Experro Admin Panel**

### Create an API Token in BigCommerce

<Steps>
  <Step title="Access Store‑Level API Accounts">
    * Log in to your BigCommerce admin panel.
    * Navigate to **Settings** → **Store‑Level API Accounts**.\\
          <img src="https://mintcdn.com/experro/jT9kDcQDGoTnsB0Y/images/plug_and_play/bigcommerce_integration/bc_step1.png?fit=max&auto=format&n=jT9kDcQDGoTnsB0Y&q=85&s=3bef2cc7095d390dc5ef1c3150e59603" alt="" width="1919" height="1079" data-path="images/plug_and_play/bigcommerce_integration/bc_step1.png" />
  </Step>

  <Step title="Create a New API Account">
    * Click **Create API Account**.
    * For **Token Type**, select **V2/V3 API Token**.
    * Give the account a descriptive name (e.g., `exp_discovery`).
    * The **API Path** will be populated automatically.\\
          <img src="https://mintcdn.com/experro/jT9kDcQDGoTnsB0Y/images/plug_and_play/bigcommerce_integration/bc_step2.png?fit=max&auto=format&n=jT9kDcQDGoTnsB0Y&q=85&s=81faecdfe39508a6ca4ff27032163bf4" alt="" width="1919" height="1079" data-path="images/plug_and_play/bigcommerce_integration/bc_step2.png" />
  </Step>

  <Step title="Configure OAuth Scopes">
    * In the scopes list, enable the permissions required by Experro for full functionality. Refer to the BigCommerce admin panel screenshot provided below.

    <div style={{ overflowX: "auto", maxWidth: "100%", maxHeight: "600px"}}>
      <img src="https://mintcdn.com/experro/xVZj88fL1VZEp_OF/images/plug%20and%20play/scope_bc.png?fit=max&auto=format&n=xVZj88fL1VZEp_OF&q=85&s=6e503c9c6f80f9102171308277c6654e" alt="Detailed diagram showing required OAuth scopes" style={{ display: "block", height: "auto" }} width="505" height="2696" data-path="images/plug and play/scope_bc.png" />
    </div>
  </Step>

  <Step title="Save and Retrieve Credentials">
    * Click **Save**. A `.txt` file containing your **Client ID**, **Client Secret**, **Access Token**, and **API Path** will automatically download.
      <Info> Store this file securely.</Info>
  </Step>
</Steps>

### Configure the Integration in the Experro Admin Panel

<Steps>
  <Step title="Navigate to Store Integration">
    * In Experro, go to **Workspace Settings** → **Store Integration**.
    * Choose **BigCommerce** and Click **Add Platform**.
    * Click **Install** to begin configuration.
          <img src="https://mintcdn.com/experro/jT9kDcQDGoTnsB0Y/images/plug_and_play/bigcommerce_integration/pp_admin_store.png?fit=max&auto=format&n=jT9kDcQDGoTnsB0Y&q=85&s=884499d8c45b27c63a2229a4848a053d" alt="" width="1919" height="1079" data-path="images/plug_and_play/bigcommerce_integration/pp_admin_store.png" />
    * Click **Add Store**.
  </Step>

  <Step title="Enter Store Details">
    * **Environment:** Select **Production** or **Development**.
    * **Store Name:** Enter a memorable identifier (e.g., `BigCommerce_store`).
  </Step>

  <Step title="Provide API Credentials">
    * **Store Hash:** Extract the `<storehash>` from your API Path (`https://api.bigcommerce.com/stores/<storehash>/v3`).
    * **Store Token:** Paste the **Access Token** from the downloaded `.txt` file.
    * **Client ID** and **Client Secret:** Also copied from the `.txt` file.\\
          <img src="https://mintcdn.com/experro/jT9kDcQDGoTnsB0Y/images/plug_and_play/bigcommerce_integration/bc_step3.png?fit=max&auto=format&n=jT9kDcQDGoTnsB0Y&q=85&s=5c0db791a86813b9fa257168c7f97c0e" alt="" width="1919" height="1079" data-path="images/plug_and_play/bigcommerce_integration/bc_step3.png" />
  </Step>

  <Step title="Test Connection">
    * Click **Test API** to verify that Experro can connect to your store.
    * Upon success, click **Next**.
  </Step>

  <Step title="Configure Data Synchronization">
    * **Languages:** Select the storefront language(s).
    * **Channel:** Choose which sales channel to integrate.\\
          <img src="https://mintcdn.com/experro/jT9kDcQDGoTnsB0Y/images/plug_and_play/bigcommerce_integration/bc_step4.png?fit=max&auto=format&n=jT9kDcQDGoTnsB0Y&q=85&s=7fcf35b8cd780d1a6888fb10fa01bef6" alt="" width="1919" height="1079" data-path="images/plug_and_play/bigcommerce_integration/bc_step4.png" />
  </Step>

  <Step title="Establish Connection">
    * Click **Connect**. Experro will begin importing your catalog, orders, and customer data.
  </Step>
</Steps>

With these steps completed, your BigCommerce store is now connected to Experro, unlocking advanced discovery, merchandising, and analytics capabilities.

## Customise UI

Once connected, you can head over to our [UI Customization guide](/plug_and_play/ui_customisation) to design your discovery interface.

## Theme Integration

Once the UI customisation is complete, follow the [Theme Integration guide](/plug_and_play/bigcommerce_integration/theme_integration) to make your changes live on BigCommerce.