Shopify

Set up in Shopify admin, or Settings → Integrations

Evident runs as an embedded Shopify app: the dashboard renders inside the Shopify admin, and catalogue and orders sync automatically.

Read this before you commit to loyalty

Loyalty points do not currently accrue from orders on Shopify.

This is structural rather than a bug awaiting a fix. Evident awards points when an order reaches a fulfilment status — Completed, Shipped, Awaiting Fulfillment. Shopify’s order status is a payment state (paid, pending, refunded), so it never matches and no award is ever made.

Everything else works: loyalty accounts exist, tiers calculate, points can be granted through the API or by hand, and rewards redeem as store credit or a discount code. It is specifically automatic accrual from orders that does not fire.

If automatic points on purchases is the reason you are adopting Evident, raise it with us before you build a programme on it.

Installing

Install the app and approve the scopes. The dashboard then opens inside the Shopify admin.

Shopify’s admin does not permit the app to use cookies, so the embedded session works differently under the hood: Shopify’s session token is exchanged once at entry for an Evident token carried on every subsequent request. This is invisible unless you are debugging — but it does mean the session lives in the page, so a hard refresh re-establishes rather than resumes it.

Because Shopify’s session token carries no email address, every Shopify embedded session is scoped to that store: it can work with that store’s data and nothing else — no organization settings, no billing, no other stores. To give someone full access, invite them properly under Settings → Team.

Scopes

read_products · read_orders · read_all_orders · read_customers · read_content · write_script_tags, plus write_discounts and write_store_credit_account_transactions for loyalty redemption.

If your connection predates loyalty it almost certainly lacks the last two. Shopify prompts for new scopes on next load.

Widgets

Add the script from Storefront → Install & Theme to your theme, and containers in your Liquid templates. Product ID is {{ product.id }}.

<div data-evident-widget="star-badge" data-product-id="{{ product.id }}"></div>
<div data-evident-widget="review-list" data-product-id="{{ product.id }}"></div>

Store credit currency

Store credit on Shopify is currently issued in USD regardless of the store’s currency. If you sell in another currency, set the redemption method to coupon rather than store credit until this is fixed.

Billing

Stores installed from the Shopify App Store bill through Shopify — the charge appears on your Shopify invoice and uninstalling cancels it. Stores connected directly from Evident bill through us.

Uninstalling

Uninstalling stops sync. Reviews, loyalty balances, FAQs and galleries stay with the store environment and are there if you reinstall.