Skip to main content

General

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.
A: Currently Shopify and BigCommerce. Support for additional platforms is planned for future releases.

Prerequisites

  • 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)
  • 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

Shopify Integration

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

BigCommerce Integration

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

Troubleshooting & Support

  • 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.
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 for details.
For separate dev and prod stores, repeat the integration and publish steps in each environment using the appropriate credentials and store references.
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.