Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt

Use this file to discover all available pages before exploring further.

The User Intuition Shopify app is an embedded admin app that bridges your Shopify store and your User Intuition workspace. Once installed, customers and customer segments sync automatically into User Intuition so you can recruit existing buyers as Participants for Studies and Interviews — directly from inside the Shopify Admin.

​
What you can do with the Shopify app

Sync your customer base

Imported customers become Participants you can invite to Interviews — including their name, email, phone, and order history.

Sync customer segments

Shopify customer segments (for example, VIPs, recent buyers, or churned customers) sync into User Intuition so you can target Studies at the audience that matters.

Run Studies in-admin

Browse your Studies, create new ones, and check sync status from inside the Shopify Admin — no separate login required.

Stay GDPR-compliant

The app implements Shopify’s required compliance webhooks so customer-data and shop-redaction requests are honored automatically.

​
Installing the app

The User Intuition app is an OAuth-based Shopify app. Installation creates a Shop record on the User Intuition side and bootstraps your User Intuition account automatically — you don’t need to sign up separately first.
1

Install from the Shopify App Store

Locate the User Intuition listing and click the install action. Shopify will walk you through the standard OAuth permission grant.
2

Approve the requested scopes

The app requests read access to customers and orders so it can sync segments and customer profiles into User Intuition. No write scopes are requested.
3

Land in the embedded admin UI

After approving, Shopify redirects you to the embedded app inside your Admin. The app auto-creates your User Intuition account using your shop’s email on file — there is no extra sign-in step.
4

Initial sync runs in the background

The app immediately kicks off a customer and segment sync. You can keep working while it completes.
Your User Intuition user is linked to your shop domain. If you uninstall and reinstall on the same shop, the app reconnects to your existing account rather than creating a new one.

​
The embedded admin UI

The User Intuition app appears in your Shopify Admin under Apps. Opening it loads the embedded UI inside the Shopify Admin shell — you never leave the Admin tab. From inside the embedded app you can:
  • See current sync status (pending, syncing, segments synced, complete) and how many customers have been imported so far
  • Browse your Studies and their status (creating, fielding, complete, and so on)
  • Create a new Study using the in-Admin Study builder
  • Open deep links to your User Intuition workspace for anything that lives outside the embedded experience
The embedded UI uses Shopify Polaris components, so it looks and feels native to the Shopify Admin.

​
What syncs and how often

Two kinds of data sync from Shopify into User Intuition: segments and customers.
DataDirectionTrigger
Customer segmentsShopify → User IntuitionOn install, and whenever a sync is initiated
Customers (with email, phone, orders, tags)Shopify → User IntuitionOn install, and whenever a sync is initiated
Default “All Customers” segmentCreated in User IntuitionOn first connection

​
Batched sync

Customer syncs run in batches rather than as a single large request. This keeps each request small enough to be reliable on large stores and lets the embedded UI report progressive status updates as batches complete. You’ll see counts climb in the embedded app as batches are processed. The sync flow at a high level:
  1. The embedded app fetches segments from the Shopify Admin GraphQL API and posts them to User Intuition.
  2. The app then walks through customers in batches, posting each batch.
  3. Each Participant is upserted on a stable (shop_domain, customer_id) key, so re-runs don’t create duplicates.
  4. Customers are linked to the segments they belong to in Shopify.
  5. When the final batch completes, the connection status flips to complete.
Re-running a sync is safe. It refreshes existing Participants and segments rather than creating duplicates.

​
Inviting customers to Interviews

Once customers are synced, they appear as Participants inside your User Intuition workspace. From there you can:
  • Filter Participants by the Shopify segment they belong to (for example, only invite VIPs)
  • Search Participants by name, email, or phone
  • Select Participants and invite them to a Study
Each Participant carries their full Shopify customer object (orders, total spent, tags, and so on) so you can use that context when building screeners or reviewing Interview responses.

​
GDPR and compliance webhooks

Shopify requires every public app to implement three compliance webhooks. The User Intuition app subscribes to all of them:
WebhookWhat we do
customers/data_requestAcknowledge the request so the merchant can fulfill it. Imported Participant data lives under your User Intuition account.
customers/redactRemove the affected customer’s Participant record and any imported metadata for them.
shop/redactRemove all imported segments, Participants, and shop state associated with the uninstalled shop.
Compliance webhooks fire on Shopify’s schedule (typically 48 hours after uninstall for shop redaction). If you need a customer’s data removed immediately, trigger redaction from your Shopify Admin rather than waiting for the scheduled webhook.

​
Disconnecting and uninstalling

You can disconnect the integration at any time by uninstalling the app from your Shopify Admin’s Apps page. When you uninstall:
1

Shopify fires the app-uninstalled webhook

Shopify notifies the User Intuition app that your shop has uninstalled.
2

The app calls the User Intuition delete endpoint

User Intuition removes the external connection record and the shop’s imported segments and Participants from your workspace’s external integration tables.
3

Local shop state is cleaned up

The app’s local Shop record and sync state are removed.
4

Compliance redaction follows

Shopify later fires shop/redact (typically after 48 hours), which triggers a final sweep to make sure nothing tied to the shop remains.
Studies you’ve already created and Interview transcripts you’ve already collected are part of your User Intuition workspace — they are not deleted when you uninstall the Shopify app. Only the integration link and the imported customer/segment data are removed.

​
Common setup pitfalls

Shop email missing on Shopify

Auto-bootstrap uses the shop’s contact email on file in Shopify to create or look up your User Intuition account. If that email is blank, set it under Settings → Store details before opening the embedded app for the first time.

Very large customer bases

Stores with hundreds of thousands of customers may take several minutes for the initial sync to complete. The embedded app shows progressive batch counts — let it run rather than refreshing repeatedly.

No segments visible after install

If you haven’t created any customer segments in Shopify yet, only the default “All Customers” segment will appear in User Intuition. Create segments in Customers → Segments in your Shopify Admin and re-run the sync.

Reinstalling on the same shop

Reinstalling reconnects to your existing User Intuition workspace. Studies, Participants, and balances persist across reinstalls on the same shop domain.

​
Next steps

Create a Study

Build a Study and invite your synced Shopify customers as Participants.

Invite customers

Filter, search, and invite imported customers to Interviews.