How to integrate Truelist with Shopify
Truelist has a direct integration with Shopify that validates the email addresses of your customers and writes the results back to your store automatically — no CSV downloads needed. This guide walks you through installing the app, running your first sync, and using the results.
How the integration works
When you connect Shopify, Truelist fetches all customers from your store and validates each email address through its full validation pipeline. Once validation is complete, Truelist tags each customer in Shopify with one of the following tags:
- truelist-valid — The email address is valid and safe to send to.
- truelist-risky — The email address may be valid but carries some risk (e.g. a disposable or role address).
- truelist-invalid — The email address is invalid and should not be sent to.
- truelist-unknown — Truelist could not determine the validity of the email address.
These tags appear in the Tags section of each customer’s profile in your Shopify admin, so you can filter and segment your customers by validation result.
Note: Truelist only manages its own
truelist-*tags. On each sync it replaces any previous Truelist tag with the latest result and leaves all of your other customer tags untouched.
Step 1: Install the Truelist app from Shopify
- From the Truelist Shopify app listing, click Install and choose the store you want to connect.
- Review the requested permissions and approve the installation. Truelist only requests access to read and tag your customers.
Once installed, the Truelist app will appear in your store’s Apps menu.
Step 2: Open the integration in Truelist
After installing the app, open it to land on the Shopify integration page inside Truelist. You can also reach it any time from Settings → Integrations in your Truelist account.
This page shows your connected Store, the number of Customers Truelist found, and the time of the Last successful sync.
Step 3: Start your first sync
Click Sync now to kick off your first validation run. Truelist pulls your customer list from Shopify and begins validating each email address.
A batch named Shopify Customers appears in the Verify a List section of your Truelist account so you can track progress.
Note: The CSV download for this batch will be empty. Results are written back directly to Shopify as customer tags — not exported as a file. The list is only there so you can track progress.
Viewing results
Once the sync completes, open Customers in your Shopify admin and click into any customer. Their validation result appears as a truelist-* tag in the Tags section of the profile.
You can filter your customer list by tag in Shopify to quickly find every customer with an invalid or risky address, then build a segment that excludes them from your campaigns.
Managing the integration
Syncing
Once connected, Truelist re-validates your customer list automatically on a weekly basis. You can also trigger a sync at any time with the Sync now button.
Deleting the integration
Click Delete Shopify integration to remove the connection. This stops all syncing but does not remove any data — tags already written to your Shopify customers are preserved. You can reconnect at any time.
Frequently asked questions
How often will my Shopify customers sync automatically?
Truelist syncs your customer list once per week. You can also run a sync on demand with the Sync now button.
Will Truelist re-validate customers it has already checked?
Yes. Truelist re-validates existing customers according to the revalidation period configured in your validation settings. The default is 60 days.
Will my existing customer tags be overwritten?
No. Truelist only manages tags that begin with truelist-. On each sync it replaces the previous Truelist tag with the latest result and leaves all of your other tags untouched.
Why is the CSV empty when I download from the Verify a List section?
This is expected. When syncing with Shopify, validation results are written back directly to your store as customer tags. The list in Truelist is only used to track progress — your results live in Shopify.
Does Truelist modify any customer data other than tags?
No. Truelist only adds or updates the truelist-* tag on each customer. It does not modify any other customer fields, delete customers, or change order or product data.
What happens if the app loses access to my store?
If Truelist cannot authenticate with Shopify during a sync, the integration is automatically disabled and you will receive an email notification. Reinstall or reconnect the app from Settings → Integrations → Shopify to resume syncing.
Why are some customers tagged truelist-unknown?
An unknown result means Truelist’s validation pipeline could not definitively confirm or deny the email address. This can happen with restrictive mail servers, catch-all domains, or temporary connectivity issues. Running another sync may resolve some unknowns over time.