Add Google Analytics Code to Filament: Render Hooks

Installing the Google Analytics script in Filament is not that easy. Especially once you open the resources folder and realize there are no views. So, where do you put the script? You use Filament Theme Hooks!

Adding the Script

Since Filament does not publish its views - you need to use render hooks. We will use the panels::head.start hook to add our GA script after the opening <head> tag:

Providers/Filament/AdminPanelProvider.php

public function panel(Panel $panel): Panel
   {
       return $panel
           ->default()
           ->id('admin')
           ->path('admin')
           ->login()
           ->colors([
               // ...
           ])
           ->discoverResources(in: app_path('Filament/Resources'), for: 'App\\Filament\\Resources')
           ->discoverPages(in: app_path('Filament/Pages'), for: 'App\\Filament\\Pages')
           ->pages([
               // ...
           ])
           ->discoverWidgets(in: app_path('Filament/Widgets'), for: 'App\\Filament\\Widgets')
           ->widgets([
               // ...
           ])
           ->renderHook(
               'panels::head.start',
               fn () => view('analyticsTag'),
           )
           ->middleware([
               // ...
           ])
           ->authMiddleware([
               // ...
           ]);
   }

Once we register the hook, we must create the view to render the script:

resources/views/analyticsTag.blade.php

<script async src="https://www.googletagmanager.com/gtag/js?id=XXXXXXXXXXXXXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
 
  gtag('config', 'XXXXXXXXXXXXXXXXXXXXX');
</script>