Install Humind on Shopify
Add the Humind Agent to the connected Shopify store using the supported installation flow Follow a safe workflow, verify the customer-facing result, and isolate common problems.
Add the Humind Agent to the connected Shopify store using the supported installation flow This guide keeps the work focused on Shopify deployment and provides a repeatable path that a new Humind user can follow without changing unrelated configuration.
Deployment connects a configured Agent to a customer-facing sales channel. The installation method depends on the storefront, but every launch needs an allowed domain, a single valid embed, a visible entry point, and tests on the real site. Workspace testing remains useful, yet it cannot replace validation in the deployed environment.
Before you begin
Access: Humind deployment access and sufficient Shopify theme or app permissions are required.
- Connect the correct Shopify shop and market.
- Complete catalog synchronization and Agent testing.
- Identify the live theme and any existing Humind installation.
Work in the smallest owning area described below and keep the current customer-facing state available while you prepare the change. Before clicking any final action, confirm the active company, Agent, store, language, and market shown in Humind. A missing control can indicate read-only access or a capability that is not configured for this company. In that case, record the intended task and ask an administrator to review the exact permission or dependency. Do not bypass the boundary by sharing an account, copying data into another area, or promising a capability that the workspace does not expose.
Step-by-step workflow
Confirm the scope and current state
Open the Shopify sales channel for the selected Agent and follow the connected installation path rather than copying an embed from another store.
- Confirm the active company and Agent before editing.
- Record the current state so the result can be compared after the change.
- Stop if the screen or permission does not match the intended task.
Prepare the change
Enable the Humind theme integration or app block in the intended live theme and save Shopify changes.
- Use the smallest change that completes the customer task.
- Keep authoritative information in its owning source.
- Review labels, dates, language, and customer-visible wording before saving.
Save and allow required processing to finish
Return to Humind to review installation status, allowed domains, and the Agent associated with the shop.
- Wait for the interface to confirm that the change is saved.
- If synchronization, indexing, or publication is required, wait for its final state.
- Reload the area and confirm the saved values persist.
Test the complete customer journey
Test the live storefront in a private session across home, collection, and product pages, including a catalog question and human-support scenario.
- Use a fresh session and a realistic customer scenario.
- Check desktop and mobile when the result appears on a storefront.
- Capture the exact failing step if the outcome differs from the expectation.
Important limits and operating notes
- A successful save confirms persistence, not every downstream synchronization or public update.
- Workspace permissions can hide an area or allow reading without allowing changes.
- Do not copy volatile catalog, account, or customer facts into narrative content as a workaround.
- Test only supported capabilities that are visible and configured for the current company.
- Keep changes in Shopify deployment separate from unrelated Agent, Knowledge, catalog, Inbox, or Helpdesk work.
Verify the result
- The integration is enabled in the intended live theme.
- Only one Humind entry point appears.
- The correct store, market, catalog, and Agent are used.
- The experience works after navigation and on mobile.
Keep a short record of what you tested, which customer scenario you used, and what changed. This makes later troubleshooting more precise and helps another teammate reproduce the result without relying on memory.
Troubleshooting
The Shopify installation option is unavailable
Confirm the shop connection, current company, permissions, and supported sales channel. Do not substitute an unrelated shop identifier.
The theme editor looks correct but the live store does not
Verify which theme is published, save the integration, and check storefront consent, caching, allowed domains, and duplicate theme or tag-manager installs.