Install on Laravel

Find where users get stuck in your Laravel app.

Paste the Cuttl Tag into the head of your main Blade layout, and every page that uses the layout gets it.

Add Cuttl to your Blade layout

  1. Sign in to Cuttl, or create a free account. Add your site with its domain. Open the site’s Install tab and copy the Cuttl Tag. It starts with <!-- Start Cuttl -->.
  2. Open the layout your pages use. It’s often resources/views/layouts/app.blade.php, or resources/views/components/layouts/app.blade.php in newer starter kits.
  3. Paste the Cuttl Tag inside <head>, between @verbatim and @endverbatim. @verbatim tells Blade to leave the Cuttl Tag exactly as it is.
    app.blade.php
    <head>
        {{-- your other head tags --}}
        @verbatim
        <!-- Paste your Cuttl Tag here -->
        @endverbatim
    </head>
  4. Deploy.
  5. In Cuttl, turn on Journey Insights for heatmaps and recordings, or Web Experiments for A/B tests. Admins can do it on the product’s page or in Settings → Plan & usage. A new workspace starts with both off, and until one is on, Cuttl keeps nothing from your site.

Check it works

  1. Open any page of your live site in a browser.
  2. In Cuttl, open the site’s Install tab. It shows when data last arrived, usually within a minute.
  3. Nothing yet? View the live page’s source and search for app.cuttl.io to check the Cuttl Tag is there. Then check that the site’s domain in Cuttl matches the address in your browser.

Still not there? Run php artisan view:clear on the server, so Laravel rebuilds its cached views.

Good to know

  • If your app has more than one layout, for example one for guests and one for signed-in users, add the Cuttl Tag to each layout visitors see.
  • Inertia and Livewire’s wire:navigate change pages without a full reload. Each change counts as a page view.
  • If your app sets a Content Security Policy nonce, add it to the script tag. The scripts Cuttl adds inherit it.
  • To leave out your own sessions, open any page of your site once with ?cuttl_ignore=1 at the end of the address.
Questions

Laravel questions

Is there a Composer package?

No. The Cuttl Tag in your layout is all you need.

Will it slow my app down?

No. The Cuttl Tag is under 1.7 KB and loads the rest in the background, so it never blocks the page.

See where visitors get stuck.

Free for one site. Add the Cuttl Tag, turn on Journey Insights, and your first sessions show up in Cuttl.