Plug & Play Integration
FAQs
General
Q1. What is the Experro Plug & Play feature?
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.
Q2. Which e-commerce platforms does Plug & Play support?
Q2. Which e-commerce platforms does Plug & Play support?
A: Currently Shopify and BigCommerce. Support for additional platforms is planned for future releases.
Prerequisites
Q3. What do I need before starting a Shopify integration?
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)
Q4. What do I need before starting a BigCommerce integration?
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
.txtfile containing your API token, Client ID, and Client Secret
Shopify Integration
Q5. How do I connect my Shopify store to Experro?
Q5. How do I connect my Shopify store to Experro?
- In Shopify Admin: Settings → Apps & Sales Channels → Develop apps → Create app.
- Set the App Name, then under Configure Admin API scopes, enable all required scopes (e.g.,
read_products,write_themes, etc.). - Return to the Overview tab and click Install, then copy the displayed access token.
- 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.
Q6. How do I publish Experro in Shopify once the UI is customized?
Q6. How do I publish Experro in Shopify once the UI is customized?
Only for Experro Default Theme.
- In Shopify Admin: Online Store → Themes → Customize.
- On the category/listing page, Add Section → Custom Liquid.
- Paste:
- Hide the default product grid, then Save.
- In Experro Admin UI Customisation → CSS & JS, paste the required JS snippet.
- Click Publish; your Experro Discovery UI goes live.
BigCommerce Integration
Q7. How do I create the API token in BigCommerce?
Q7. How do I create the API token in BigCommerce?
- In BigCommerce Admin: Settings → Store API Accounts → Create API Token.
- Choose V2/V3 API Token, name it (e.g.,
exp_discovery), leave Path default, select OAuth scopes as needed. - Click Save to download a
.txtfile containing your Client ID, Client Secret, Access Token, and API Path.
Q8. How do I connect BigCommerce to Experro?
Q8. How do I connect BigCommerce to Experro?
- In Experro Admin: Workspace Settings → Store Integration → Add Platform → BigCommerce → Install.
- Enter Environment, Store Reference Name, then from your
.txtfile:- Store Hash (from the API Path URL)
- Client ID, Client Secret, Access Token
- Test API connection, then configure language and metafield namespaces.
- Click Connect.
Q9. How do I publish Experro in BigCommerce?
Q9. How do I publish Experro in BigCommerce?
Only for Experro Default Theme.
- In BigCommerce Admin: Storefront → Themes → Edit Theme Files.
- Open
templates/pages/category.html, comment out the existing product grid container and replace with: - Save & Apply.
- In Experro Admin UI Customisation → CSS & JS, paste the provided JS snippet.
- Save, Preview, and Publish.
Troubleshooting & Support
Q10. What if my connection test fails?
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.
Q11. Can I customize the look & feel after integration?
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 for details.
Q12. Do I need to repeat these steps for new environments?
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.