> ## 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.

# FAQs

## General

<Accordion title="Q1. What is the Experro Plug & Play feature?">
  A: Plug & Play lets merchants quickly enable Experro’s AI‑driven search, merchandising, and analytics on their storefront without custom development. You install a small app or install token, configure settings in the Experro Admin Panel, then publish the UI components (search bar, facets, etc.) directly to your live store.
</Accordion>

<Accordion title="Q2. Which eCommerce platforms does Plug & Play support?">
  A: Currently Shopify and BigCommerce. Support for additional platforms is planned for future releases.
</Accordion>

## Prerequisites

<Accordion title="Q3. What do I need before starting a Shopify integration?">
  * A Shopify store with admin access
  * Permission to create a custom app and configure API scopes
  * A safe place to store the generated Admin API access token (you see it only once)
</Accordion>

<Accordion title="Q4. What do I need before starting a BigCommerce integration?">
  * A BigCommerce store with admin access
  * Permission to create a Store‑level API account
  * The downloaded `.txt` file containing your API token, Client ID, and Client Secret
</Accordion>

## Shopify Integration

<Accordion title="Q5. How do I connect my Shopify store to Experro?">
  1. In Shopify Admin: **Settings → Apps & Sales Channels → Develop apps → Create app**.
  2. Set the App Name, then under **Configure Admin API scopes**, enable all required scopes (e.g., `read_products`, `write_themes`, etc.).
  3. Return to the Overview tab and click **Install**, then copy the displayed access token.
  4. In Experro Admin: **Workspace Settings → Store Integration → Add Store**.
     * Select **Shopify**, enter Environment, Store Reference Name, Shopify Domain, Admin API Token, API Key, and API Secret.
     * Test credentials, then configure language and metafield namespaces.
     * Click **Connect**.
</Accordion>

<Accordion title="Q6. How do I publish Experro in Shopify once the UI is customized?">
  > *Only for Experro Default Theme.*

  1. In Shopify Admin: **Online Store → Themes → Customize**.
  2. On the category/listing page, **Add Section → Custom Liquid**.
  3. Paste:
     ```html theme={null}
     <div style="min-height: 100vh;">
       <div id="exp-cat-page-selector"></div>
     </div>
     ```
  4. Hide the default product grid, then **Save**.
  5. In Experro Admin **UI Customisation → CSS & JS**, paste the required JS snippet.
  6. Click **Publish**; your Experro Discovery UI goes live.
</Accordion>

## BigCommerce Integration

<Accordion title="Q7. How do I create the API token in BigCommerce?">
  1. In BigCommerce Admin: **Settings → Store API Accounts → Create API Token**.
  2. Choose **V2/V3 API Token**, name it (e.g., `exp_discovery`), leave Path default, select OAuth scopes as needed.
  3. Click **Save** to download a `.txt` file containing your Client ID, Client Secret, Access Token, and API Path.
</Accordion>

<Accordion title="Q8. How do I connect BigCommerce to Experro?">
  1. In Experro Admin: **Workspace Settings → Store Integration → Add Platform → BigCommerce → Install**.
  2. Enter Environment, Store Reference Name, then from your `.txt` file:
     * **Store Hash** (from the API Path URL)
     * **Client ID**, **Client Secret**, **Access Token**
  3. Test API connection, then configure language and metafield namespaces.
  4. Click **Connect**.
</Accordion>

<Accordion title="Q9. How do I publish Experro in BigCommerce?">
  > *Only for Experro Default Theme.*

  1. In BigCommerce Admin: **Storefront → Themes → Edit Theme Files**.
  2. Open `templates/pages/category.html`, comment out the existing product grid container and replace with:
     ```html theme={null}
     <div style="min-height: 100vh;">
       <div id="exp-cat-page-selector"></div>
     </div>
     ```
  3. Save & Apply.
  4. In Experro Admin **UI Customisation → CSS & JS**, paste the provided JS snippet.
  5. Save, Preview, and Publish.
</Accordion>

***

## Troubleshooting & Support

<Accordion title="Q10. What if my connection test fails?">
  * Double‑check your API credentials (token, keys, store hash/domain).
  * Ensure the required scopes are enabled and that your store has API access.
  * If issues persist, contact Experro Support with a screenshot of the error.
</Accordion>

<Accordion title="Q11. Can I customize the look & feel after integration?">
  Yes—use the **UI Customisation** section in Experro Admin to adjust Theme, Layout, Search Results, Autocomplete, CSS & JS, and Translations. See the [UI Customisation guide](/plug_and_play/ui_customisation) for details.
</Accordion>

<Accordion title="Q12. Do I need to repeat these steps for new environments?">
  For separate dev and prod stores, repeat the integration and publish steps in each environment using the appropriate credentials and store references.
</Accordion>

These FAQs should address the most common questions encountered during Plug & Play integration with Shopify and BigCommerce. If you have additional questions, please reach out to our support team or consult the full documentation.