# Laravel
## Add Humblytics Analytics to a Laravel Site
### 1 · Sign up (or log in)
Visit humblytics.com → Start Free Trial. Finish signup—or log in to your existing workspace.
### 2 · Add your website in Humblytics
In the sidebar, click **Add Website**.
* **Domain** – enter your site's domain (omit `https://` and `www`)
* **Site Name** – internal label (e.g. `Marketing-Laravel`)
Copy the snippet from **Install Tracking Code**:
html
```html
```
Keep this tab open—we'll return and click **Verify Website** once the tag is live.
### 3 · Add the script to your Laravel project
#### Option 1: Blade layout (recommended for most apps)
**Best for:** Traditional Blade template apps
1. Open your main layout file, typically:
* `resources/views/layouts/app.blade.php`
* Or `resources/views/layouts/master.blade.php`
2. Add your Humblytics script just before the closing `` tag:
blade
```blade
{{ config('app.name', 'Laravel') }}
@vite(['resources/css/app.css', 'resources/js/app.js'])
@production
@endproduction
@yield('content')
```
3. Ensure your pages extend this layout:
blade
```blade
@extends('layouts.app')
@section('content')
@endsection
```
**Note**: The `@production` directive ensures the script only loads in production, not during local development.
#### Option 2: Using environment variables (recommended)
**Best for:** Managing multiple environments (staging, production)
1. Add your Humblytics ID to `.env`:
env
```env
HUMBLYTICS_ID=YOUR_ID_HERE
```
2. In your layout file (`resources/views/layouts/app.blade.php`):
blade
```blade
{{ config('app.name', 'Laravel') }}
@vite(['resources/css/app.css', 'resources/js/app.js'])
@if(config('app.env') === 'production' && env('HUMBLYTICS_ID'))
@endif
@yield('content')
```
3. Add to `.env.production` or your production environment
**Note**: Replace `YOUR_ID_HERE` with your actual project ID from Humblytics.
#### Option 3: Blade component (Laravel 8+)
**Best for:** Modern Laravel apps using Blade components
1. Create a new component:
bash
```bash
php artisan make:component Analytics
```
2. Edit `app/View/Components/Analytics.php`:
php
```php
environment('production') && config('services.humblytics.id');
}
}
```
3. Create `resources/views/components/analytics.blade.php`:
blade
```blade
```
4. Add to `config/services.php`:
php
```php
'humblytics' => [
'id' => env('HUMBLYTICS_ID'),
],
```
5. Add to your layout's ``:
blade
```blade
```
#### Multiple layouts
If your app uses multiple layout files (e.g., `app.blade.php`, `guest.blade.php`, `admin.blade.php`), add the script to each layout file, or:
1. Create a partial: `resources/views/partials/analytics.blade.php`
2. Add the Humblytics script to this file
3. Include in each layout: `@include('partials.analytics')`
### 4 · Deploy and verify
1. **Clear Laravel caches**:
bash
```bash
php artisan view:clear
php artisan config:clear
php artisan cache:clear
```
2. Deploy your changes to production
3. Return to Humblytics and click **Verify Website**
4. Open your live site in a private/incognito window and refresh once
5. Within \~30 seconds you should see a green **Verified** badge and live visitor count
**If verification fails, check:**
* Script ID matches your project in Humblytics
* You deployed to production (not testing localhost)
* You cleared Laravel's view cache
* The `@production` or environment check allows the script to load
* View page source (right-click → View Page Source) and search for "humblytics"
* No ad-blockers or browser extensions are interfering
**Debug in Laravel:**
bash
```bash
# Check if views are cached
php artisan view:clear
# Check config cache
php artisan config:clear
# Verify environment
php artisan env
```
### 5 · Explore & optimize
* **Dashboard** – see traffic, top pages, and referrers
* **Heatmaps** – auto-generated scroll and click maps
* **Experiments** – run A/B tests directly from Humblytics
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.humblytics.com/how-to-get-started/laravel.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.