LuriaDocs
Install

Install with Google Tag Manager

Load the Luria snippet through a GTM Custom HTML tag on all pages, and know when a direct head install is the better choice.

plain textupdated 2026-08-19

About 6 minutes

What you'll need

  • A Luria account at luriart.com/app
  • Publish access to your Google Tag Manager container
  • Your Luria Site ID (Step 1)

Direct install is better. GTM works, but it's second-best.

A snippet pasted straight into your site's <head> loads before anything else, which is what keeps visitors from seeing a flash of the original page before Luria's version. GTM loads Luria one step later, so flicker is more likely, especially on slow connections. If you can edit your head, use the custom site guide or your platform's guide instead. Use GTM when it's the only thing you have access to.

Step 1: Copy your Site ID

Sign in at luriart.com/app and open Settings > Install. Copy the snippet:

<script async src="https://luriart.com/snippet.js" data-luria-site="YOUR_SITE_ID"></script>

Step 2: Create a Custom HTML tag

  1. Open your container at tagmanager.google.com.
  2. Go to Tags > New.
  3. Name it Luria.
  4. Click Tag Configuration > Custom HTML.
  5. Paste the snippet into the HTML box.

Step 3: Trigger on all pages, as early as possible

Under Triggering, pick Initialization - All Pages. If your container doesn't show that option, use All Pages (Page View). Initialization fires earlier, which is what you want.

Click Save.

Step 4: Preview, then publish

Click Preview, enter your site URL, and confirm the Luria tag shows under "Tags Fired" on the first page load. Then click Submit > Publish.

Nothing goes live until you publish. A tag sitting in a draft workspace does nothing.

Step 5: Verify

Open your site in a private window. In the Luria dashboard, look for the "Tracking live" indicator within about 60 seconds. Full checklist: Verify your install.

Conversions: Luria auto-detects URLs containing /thank-you, /thank_you, or /orders/<id> on non-Shopify sites. For anything else, add a second Custom HTML tag fired on your confirmation page that calls window.luria.convert("purchase", 129.00) or window.luria.convert("lead"). Details in the JavaScript events reference. On Shopify, skip this: purchases are counted by the app, not the snippet.

Troubleshooting

Next steps

On this page