plausible · metmarkosaric · May 26, 2026 · May 26, 2026
diff --git a/docs/account-settings.md b/docs/account-settings.md
@@ -1,5 +1,6 @@
 ---
-title: Your account settings section
+title: Plausible account settings
+sidebar_label: Account settings
 description: "Manage your Plausible Analytics account settings. Update your email, secure your account with 2FA, manage active sessions, and set your dashboard preferences."
 ---
 

diff --git a/docs/agencies-and-freelancers.md b/docs/agencies-and-freelancers.md
@@ -1,5 +1,6 @@
 ---
 title: Using Plausible as an agency or freelancer
+sidebar_label: Agencies and freelancers
 description: "How agencies and freelancers use Plausible Analytics to manage multiple clients. Covers team structures, per-client billing and site ownership transfer on handoff."
 ---
 

diff --git a/docs/buttondown.md b/docs/buttondown.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add the script to Buttondown
+title: Adding Plausible to Buttondown
+sidebar_label: Buttondown
 description: "Track your Buttondown newsletter archives, link clicks and subscriber conversions in Plausible Analytics. Setup guide with goal configuration."
 ---
 

diff --git a/docs/carrd-integration.md b/docs/carrd-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: Adding Plausible to Carrd (and tracking custom events)
+title: Adding Plausible to Carrd
+sidebar_label: Carrd
 description: "Add Plausible Analytics to a Carrd site and track custom events like button clicks using an Embed component. Cookie-free and simple."
 ---
 

diff --git a/docs/csv-import.md b/docs/csv-import.md
@@ -1,5 +1,6 @@
 ---
 title: Import stats using CSV files
+sidebar_label: CSV files
 description: "Import historical analytics data into Plausible using CSV files. Works with any analytics tool that can export CSVs, including multiple properties into one dashboard."
 ---
 

diff --git a/docs/custom-locations.md b/docs/custom-locations.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: Specify a custom location to aggregate pages that contain identifiers
+title: Redact sensitive data from page URLs
+sidebar_label: Redact sensitive data from page URLs
 description: "How to send Plausible a custom URL instead of the real page URL. Useful for redacting user IDs, UUIDs or other personal data from your Top Pages report."
 ---
 

diff --git a/docs/data-access.md b/docs/data-access.md
@@ -1,5 +1,6 @@
 ---
 title: Accessing your Plausible data
+sidebar_label: Accessing your data
 description: "Choose the right way to access your Plausible data outside the dashboard: Stats API, Events API, Sites API, CSV export, Looker Studio or data warehouse connectors."
 ---
 

diff --git a/docs/discourse-integration.md b/docs/discourse-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add the script to your Discourse community
+title: Adding Plausible to Discourse
+sidebar_label: Discourse
 description: "Add Plausible Analytics to Discourse via a theme component. Uses hash-based routing support for accurate tracking of forum page views."
 ---
 

diff --git a/docs/docusaurus-integration.md b/docs/docusaurus-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add the script to your Docusaurus site
+title: Adding Plausible to Docusaurus
+sidebar_label: Docusaurus
 description: "Add Plausible Analytics to a Docusaurus documentation site using the community plugin. Privacy-friendly stats with no cookies."
 ---
 

diff --git a/docs/email-reports.md b/docs/email-reports.md
@@ -1,5 +1,6 @@
 ---
 title: Set reports to be sent through email
+sidebar_label: Email reports
 description: "Set up weekly and monthly Plausible Analytics reports delivered by email. Stats are embedded directly in the message, no login or attachments required."
 ---
 

diff --git a/docs/embed-dashboard.md b/docs/embed-dashboard.md
@@ -1,5 +1,6 @@
 ---
 title: Embed the dashboard without our branding into your user interface
+sidebar_label: Embed the dashboard
 description: "Embed a Plausible analytics dashboard into your own site or product using an iframe. Unbranded, scoped to a segment and requires no Plausible account to view."
 ---
 

diff --git a/docs/events-api.md b/docs/events-api.md
@@ -1,5 +1,6 @@
 ---
 title: Plausible Events API reference
+sidebar_label: Events API reference
 description: "Reference for the Plausible Events API. Send pageviews and custom events server-side or from mobile apps without the JavaScript snippet."
 ---
 

diff --git a/docs/excluding-localstorage.md b/docs/excluding-localstorage.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: Opt out and exclude your visits from the analytics by setting a localStorage flag in your browser
+title: Exclude yourself via localStorage
+sidebar_label: Exclude yourself via localStorage
 description: "Exclude your own visits from Plausible tracking by setting a localStorage flag in your browser's developer console. No IP address or server changes needed."
 ---
 

diff --git a/docs/ghost-integration.md b/docs/ghost-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add the script to your Ghost site
+title: Adding Plausible to Ghost
+sidebar_label: Ghost
 description: "Add Plausible Analytics to Ghost using code injection. Tracks your entire site with one snippet. No cookies, no personal data collected."
 ---
 

diff --git a/docs/google-analytics-import.md b/docs/google-analytics-import.md
@@ -1,5 +1,6 @@
 ---
 title: Import stats from Google Analytics
+sidebar_label: Google Analytics
 description: "Import your historical Google Analytics 4 data into Plausible Analytics. No gaps, no double-counting, and full support for segmenting and exporting."
 ---
 

diff --git a/docs/hubspot-analytics.md b/docs/hubspot-analytics.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add Plausible Analytics to your HubSpot site
+title: Adding Plausible to HubSpot
+sidebar_label: HubSpot
 description: "Add Plausible Analytics to your HubSpot website by injecting the tracking script site-wide. Works across all pages without cookies."
 ---
 

diff --git a/docs/hugo-integration.md b/docs/hugo-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add the script to your Hugo site
+title: Adding Plausible to Hugo
+sidebar_label: Hugo
 description: "Integrate Plausible Analytics with your Hugo site using the community plugin or by adding the script directly to your theme."
 ---
 

diff --git a/docs/integration-guides.md b/docs/integration-guides.md
@@ -1,5 +1,6 @@
 ---
 title: "Integration guides: WordPress, Shopify, Next.js and more"
+sidebar_label: Integration guides
 description: "Install Plausible Analytics on WordPress, Shopify, Webflow, Squarespace, Ghost, Next.js and more. Official guides and community integrations for popular platforms."
 ---
 

diff --git a/docs/keyboard-shortcuts.md b/docs/keyboard-shortcuts.md
@@ -1,5 +1,6 @@
 ---
 title: Navigate the dashboard using keyboard shortcuts
+sidebar_label: Keyboard shortcuts
 description: "Full list of Plausible keyboard shortcuts for switching date ranges, enabling comparisons and navigating your dashboard without touching the mouse."
 ---
 

diff --git a/docs/login-management.md b/docs/login-management.md
@@ -1,5 +1,5 @@
 ---
-title: Login management 
+title: Login management
 description: "How to view and remotely end active sessions on your Plausible Analytics account. Sessions expire automatically after 14 days of inactivity."
 ---
 

diff --git a/docs/looker-studio.md b/docs/looker-studio.md
@@ -1,5 +1,6 @@
 ---
 title: Plausible Looker Studio connector
+sidebar_label: Looker Studio connector
 description: "Connect Plausible Analytics to Google Looker Studio using the official connector. Build custom reports and branded dashboards on the Business plan."
 ---
 

diff --git a/docs/manual-link-tagging.md b/docs/manual-link-tagging.md
@@ -1,56 +1,8 @@
 ---
 displayed_sidebar: someSidebar
-title: Paid campaigns, UTM tags and conversion attribution
+title: UTM parameters
+sidebar_label: UTM parameters
 description: "How to use UTM parameters to track paid campaigns, email links and other traffic sources in Plausible. Includes naming conventions, a link builder and troubleshooting."
 ---
 
-UTM parameters are query string tags you add to URLs so Plausible can tell you which campaign, channel or source sent a visitor. Without them, traffic from newsletters, paid ads and social posts often shows up as Direct or under a referrer domain with no further detail.
-
-## The five UTM parameters Plausible supports
-
-| Parameter | What it tracks | Example value |
-|---|---|---|
-| `utm_source` | Which site or platform sent the traffic | `newsletter`, `google`, `twitter` |
-| `utm_medium` | The marketing channel | `email`, `cpc`, `social` |
-| `utm_campaign` | The campaign name | `spring-sale`, `product-launch` |
-| `utm_content` | Distinguishes multiple links within the same campaign | `banner-top`, `text-link` |
-| `utm_term` | The paid search keyword | `analytics+tool` |
-
-`utm_source`, `utm_medium` and `utm_campaign` are the most commonly used. `utm_content` and `utm_term` are optional and useful mainly for paid search or campaigns with multiple link placements.
-
-A tagged URL looks like this:
-
-```
-https://yourdomain.com/landing?utm_source=newsletter&utm_medium=email&utm_campaign=may-2025
-```
-
-## Where to view UTM data in Plausible
-
-- **Top Sources** shows `utm_source` values alongside referrer domains. See [how the Sources and Campaigns tabs work](top-referrers.md) for more detail on filtering and channel groupings.
-- **Campaigns** shows `utm_campaign` values and their traffic
-- All five parameters are available as filters so you can slice any metric by campaign, medium or source
-- Attribution is first-touch within a session: the UTM from the first pageview of a session is credited. If a visitor arrives from a tagged link mid-session, it is ignored.
-
-A session stays active for 30 minutes after the last pageview. To measure which campaigns actually lead to signups or purchases, combine UTM tracking with [goal conversions](goal-conversions.md).
-
-## Naming best practices
-
-**Use lowercase consistently.** Plausible treats `Google` and `google` as two different sources. Pick one casing and stick to it across your team.
-
-**Use hyphens as separators.** Spaces get URL-encoded as `%20` and underscores are easy to misread in reports. `spring-sale` is cleaner than `spring_sale` or `spring sale`.
-
-**Be consistent across campaigns.** If you used `email` as the medium in January, do not switch to `e-mail` in March. Inconsistent values split your data into separate rows.
-
-**Tag every link in paid campaigns.** Untagged links from ads or emails show up as Direct traffic or under the referrer domain with no campaign detail.
-
-## Building UTM links
-
-Use [Plausible's UTM builder](https://plausible.io/utm-builder) to construct tagged URLs without typos. Any spreadsheet template or other tool works just as well as long as the output follows the standard query string format.
-
-## Troubleshooting: UTM not showing in Plausible
-
-**UTMs only attribute on the first pageview of a new session.** If the visitor already has an active session when they click your tagged link, the UTM is recorded in the URL but not attributed. Test with a fresh browser profile or after 30+ minutes of inactivity.
-
-**Check for redirects that strip query parameters.** Some landing page platforms, link shorteners or server-side redirects drop query strings before the final URL loads. Open the tagged link in a browser and confirm the UTM parameters are still present in the address bar on the destination page.
-
-**Check your Plausible script settings.** If you have the `stop-tracking-utm-tags` option enabled, Plausible strips UTM parameters before recording the pageview. This is a privacy feature and means UTM data will not appear in your dashboard.
+For a full guide on UTM parameters, naming conventions, session attribution and troubleshooting, see our [UTM tracking guide](https://plausible.io/blog/utm-tracking-tags). To build and validate tagged links, use the [UTM builder](https://plausible.io/utm-builder) and [UTM checker](https://plausible.io/utm-checker) tools. For how UTM data appears in your Plausible dashboard, see [traffic sources and campaigns](top-referrers.md).
diff --git a/docs/mediawiki-integration.md b/docs/mediawiki-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add Plausible to your MediaWiki instance
+title: Adding Plausible to MediaWiki
+sidebar_label: MediaWiki
 description: "Install the Plausible extension for MediaWiki to add privacy-first, cookie-free analytics tracking to your wiki."
 ---
 

diff --git a/docs/metrics-definitions.md b/docs/metrics-definitions.md
@@ -114,7 +114,7 @@ For example, a link in your email newsletter might look like:
 https://yoursite.com/blog/post?utm_source=newsletter&utm_medium=email&utm_campaign=april-launch
 ```
 
-Read more about [tagging your links with UTM parameters](manual-link-tagging.md).
+Read more about [tagging your links with UTM parameters](https://plausible.io/blog/utm-tracking-tags).
 
 ### Referrer Drilldown
 

diff --git a/docs/nextjs-integration.md b/docs/nextjs-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: How to add the script to your NextJS site
+title: Adding Plausible to Next.js
+sidebar_label: Next.js
 description: "Add Plausible Analytics to a Next.js app using the next-plausible package. Covers script setup, custom events and proxying."
 ---
 

diff --git a/docs/plausible-script.md b/docs/plausible-script.md
@@ -1,5 +1,6 @@
 ---
 title: Add the Plausible tracking script
+sidebar_label: Add the tracking script
 description: "Add the Plausible tracking snippet to your site's header. One lightweight script, no cookies, no personal data. Works with WordPress, GTM and most site builders."
 ---
 

diff --git a/docs/proxy/guides/akamai.md b/docs/proxy/guides/akamai.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Proxying Plausible through Akamai
+sidebar_label: Akamai
 description: "Instructions for proxying Plausible Analytics through Akamai have moved. See the general proxy guide for up-to-date setup instructions."
 ---
 

diff --git a/docs/proxy/guides/apache.md b/docs/proxy/guides/apache.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Apache HTTP Server
+sidebar_label: Apache
 description: "How to proxy Plausible Analytics through Apache HTTP Server. Configure reverse proxy rules to serve analytics as a first-party connection from your domain."
 ---
 

diff --git a/docs/proxy/guides/caddy.md b/docs/proxy/guides/caddy.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Caddy
+sidebar_label: Caddy
 description: "How to proxy Plausible Analytics through Caddy. Configure Caddy as a reverse proxy to serve analytics as a first-party connection from your own domain."
 ---
 

diff --git a/docs/proxy/guides/cloudflare.md b/docs/proxy/guides/cloudflare.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Cloudflare
+sidebar_label: Cloudflare
 description: "How to proxy Plausible Analytics through Cloudflare Workers. Set up a first-party analytics connection using a free Cloudflare account in a few steps."
 ---
 

diff --git a/docs/proxy/guides/cloudfront.md b/docs/proxy/guides/cloudfront.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Proxying Plausible through CloudFront
+sidebar_label: CloudFront
 description: "Instructions for proxying Plausible Analytics through CloudFront have moved. See the general proxy guide for up-to-date setup instructions."
 ---
 

diff --git a/docs/proxy/guides/deno.md b/docs/proxy/guides/deno.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Proxying Plausible through Deno Deploy
+sidebar_label: Deno Deploy
 description: "Instructions for proxying Plausible Analytics through Deno Deploy have moved. See the general proxy guide for up-to-date setup instructions."
 ---
 

diff --git a/docs/proxy/guides/fastly.md b/docs/proxy/guides/fastly.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Proxying Plausible through Fastly
+sidebar_label: Fastly
 description: "Instructions for proxying Plausible Analytics through Fastly have moved. See the general proxy guide for up-to-date setup instructions."
 ---
 

diff --git a/docs/proxy/guides/fresh.md b/docs/proxy/guides/fresh.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Proxying Plausible through Fresh
+sidebar_label: Fresh
 description: "How to proxy Plausible Analytics through the Deno Fresh framework. Serve analytics as a first-party connection from your own domain using Fresh routes."
 ---
 

diff --git a/docs/proxy/guides/laravel.md b/docs/proxy/guides/laravel.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Laravel
+sidebar_label: Laravel
 description: "How to proxy Plausible Analytics through a Laravel application. Route the analytics script and events through your own domain as a first-party connection."
 ---
 

diff --git a/docs/proxy/guides/netlify.md b/docs/proxy/guides/netlify.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Netlify
+sidebar_label: Netlify
 description: "How to proxy Plausible Analytics through Netlify. Use Netlify redirects to serve the analytics script and events as a first-party connection from your domain."
 ---
 

diff --git a/docs/proxy/guides/nextjs.md b/docs/proxy/guides/nextjs.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Proxying Plausible with Next.js
+sidebar_label: Next.js
 description: "How to proxy Plausible Analytics in a Next.js project using the next-plausible package, which includes built-in proxy support."
 ---
 

diff --git a/docs/proxy/guides/nginx.md b/docs/proxy/guides/nginx.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Nginx
+sidebar_label: Nginx
 description: "How to proxy Plausible Analytics through Nginx. Configure reverse proxy rules in your existing Nginx setup to serve analytics from your own domain."
 ---
 

diff --git a/docs/proxy/guides/vercel.md b/docs/proxy/guides/vercel.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through Vercel
+sidebar_label: Vercel
 description: "How to proxy Plausible Analytics through Vercel. Use Vercel rewrites to serve the analytics script and events as a first-party connection from your domain."
 ---
 

diff --git a/docs/proxy/guides/wordpress.md b/docs/proxy/guides/wordpress.md
@@ -1,5 +1,6 @@
 ---
 title: Proxying Plausible through WordPress
+sidebar_label: WordPress
 description: "How to proxy Plausible Analytics on WordPress using the official plugin. No technical setup required. The plugin handles proxying automatically."
 ---
 

diff --git a/docs/script-update-guide.md b/docs/script-update-guide.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
 title: Update your Plausible script
+sidebar_label: Update your script
 description: "Migrating from the old Plausible tracking script to the updated version: what changed, how to get the new snippet and how to adjust your existing setup."
 ---
 

diff --git a/docs/shared-links.md b/docs/shared-links.md
@@ -1,5 +1,6 @@
 ---
 title: Share your stats with a private and secure link
+sidebar_label: Shared links
 description: "Create a private shared link to your Plausible dashboard so partners, clients, or advertisers can view your stats without needing a Plausible account."
 ---
 

diff --git a/docs/shopify-integration.md b/docs/shopify-integration.md
@@ -1,6 +1,7 @@
 ---
 displayed_sidebar: someSidebar
-title: Tracking checkouts, purchases and revenue attribution on Shopify
+title: Shopify ecommerce tracking
+sidebar_label: Shopify
 description: "Track add to cart, checkout, purchase and revenue attribution in Plausible Analytics on your Shopify store. No cookies required."
 ---
 

diff --git a/docs/slack-reports.md b/docs/slack-reports.md
@@ -1,5 +1,6 @@
 ---
 title: Get reports and traffic spike notifications into your Slack channel
+sidebar_label: Slack reports
 description: "Send Plausible Analytics weekly reports, monthly summaries, and traffic spike alerts directly to a Slack channel using Slack's email integration."
 ---