← All platforms

    Installation Guide · Shopify

    How to Add Agent Analytics to Your Website

    One script captures what visitors browse. That becomes memory your analytics can understand. And agents like Jack turn it into actions — recovery emails, demand segments, conversion insights.

    Install on Shopify

    🛒

    Shopify

    Shopify requires editing your theme's liquid template file. This is the standard way to add custom scripts.

    Easy·2 min·1 method

    Theme Editor

    Edit your theme's liquid file directly through the Shopify admin.

    Prerequisites

    • Shopify admin access
    • An active theme
    1
    From your Shopify admin, go to Online Store → Themes

    This is in the left sidebar under the Online Store sales channel.

    2
    Find your current (live) theme and click Edit or Customize

    Your active theme is shown at the top with an 'Active' badge. Click the three dots (⋯) next to it, then select Edit code.

    Tip: If you see Customize, click the three dots (⋯) next to it instead, then choose Edit code.

    3
    In the left sidebar, click Layout → theme.liquid

    This is the main layout file that wraps all pages. It contains the <head> tag where your script needs to go.

    Tip: You can also use the search bar at the top to find theme.liquid quickly.

    4
    Find the opening <head> tag (usually around line 5-10)

    The <head> tag is near the top of the file. You'll see other meta tags and stylesheets after it.

    Paste this
    <script async src="https://analytics.tradly.dev/tracker.js" data-server="https://analytics.tradly.dev" data-project="marketplace"></script>
    5
    Paste the tracking script right after <head>

    Add a new line after <head> and paste the script. Keep it near the top so it loads early.

    6
    Click Save in the top right corner

    Wait for the 'Asset saved' confirmation. Your changes are live immediately — no need to publish.

    Troubleshooting (4 common issues)
    • If you can't find theme.liquid, you might be using a section-based theme — try looking in Sections instead
    • Some Shopify themes lock certain files — if you get an error, contact your theme developer
    • If you're using Shopify's Dawn theme, the file is at Layout → theme.liquid
    • Caching: Shopify doesn't cache HTML by default, so changes are immediate

    Need help? Contact support@tradly.dev or check our FAQ.

    Last updated: January 2025