From 6b69f655a123ea64deff4f172268b50d579f9a2a Mon Sep 17 00:00:00 2001 From: Hricha Shandily <103104754+Hricha-Shandily@users.noreply.github.com> Date: Tue, 7 Oct 2025 14:30:52 +0530 Subject: [PATCH 1/4] Revise script update guide for clarity and updates --- docs/script-update-guide.md | 44 ++++++++++++++++++------------------- 1 file changed, 21 insertions(+), 23 deletions(-) diff --git a/docs/script-update-guide.md b/docs/script-update-guide.md index 3f3927f4..308bda76 100644 --- a/docs/script-update-guide.md +++ b/docs/script-update-guide.md @@ -2,13 +2,11 @@ title: Update your Plausible script --- -In October 2025, Plausible released a new version of their tracking script. This document outlines -the differences from the old script and how to migrate. +In October 2025, we introduced an updated version of the Plausible tracking script. This guide walks you through what’s new and how to smoothly transition from the old script. ## Why a new script? -Our previous approach with various script extensions could be uncomfortable to Plausible users -to manage. A new script also allows Plausible developers to build out new features. +Previously, managing different script extensions could be cumbersome for Plausible users. The new script streamlines the process and makes it easier for our developers to introduce new features as well. ## Getting the new snippet @@ -20,17 +18,17 @@ Your Plausible tracking snippet should be inserted into [the Header (``) s This section outlines what has changed in the new snippet and how to adjust your setup. -### 1. Each site has a unique snippet +### 1. Unique snippet per site -As a result, selecting new optional enhanced measurements no longer requires updating the snippet. +Each site now has its own snippet. This means you no longer need to update the snippet when enabling new optional enhanced measurements. -### 2. New feature: Form submission tracking +### 2. New: Form submission tracking -Tracking form submissions can now be toggled on and off in **Site Installation** settings. +You can now enable or disable form submission tracking directly from the **Site Installation** settings. -### 3. Changed: Custom properties +### 3. Updated: Custom properties -If you were using data-attributes for custom properties, you will need to add `customProperties` option with your custom properties +If you previously used data-attributes for custom properties, you will need to add `customProperties` option with your custom properties ```javascript plausible.init({ @@ -42,7 +40,7 @@ plausible.init({ Read more about custom properties in [custom pageview properties](/custom-props/for-pageviews) documentation. -### 4. Changed: Custom tracking endpoint +### 4. Updated: Custom tracking endpoint The new script no longer supports the `data-api` attribute to send events to a custom endpoint. Set `endpoint` option instead: @@ -53,7 +51,7 @@ plausible.init({ }) ``` -### 5. Changed: custom file download types +### 5. Updated: custom file download types To track file downloads only for certain file types, you will need to set `fileDownloads` option: @@ -65,9 +63,9 @@ plausible.init({ }) ``` -By default, plausible tracks the following file types: pdf, xlsx, docx, txt, rtf, csv, exe, key, pps, ppt, pptx, 7z, pkg, rar, gz, zip, avi, mov, mp4, mpeg, wmv, midi, mp3, wav, wma, dmg +By default, Plausible tracks the following file types: `pdf`, `xlsx`, `docx`, `txt`, `rtf`, `csv`, `exe`, `key`, `pps`, `ppt`, `pptx`, `7z`, `pkg`, `rar`, `gz`, `zip`, `avi`, `mov`, `mp4`, `mpeg`, `wmv`, `midi`, `mp3`, `wav`, `wma`, `dmg` -### 6. Changed: Hashed page paths +### 6. Updated: Hashed page paths If you were previously using a hash based routing and had a `.hash` in your script path, you will need to set `hashBasedRouting` option: @@ -77,9 +75,9 @@ plausible.init({ }) ``` -See also [Hashed page paths guide](/hash-based-routing.md) +See [Hashed page paths guide](/hash-based-routing.md) for details. -### 7. Changed: Tracking pageviews manually +### 7. Updated: Tracking pageviews manually If you were previously using the `manual` extension to track pageviews manually, you will need to set `autoCapturePageviews` option to `false`: @@ -89,9 +87,9 @@ plausible.init({ }) ``` -See also [Custom locations guide](/custom-locations). +See [Custom locations guide](/custom-locations) for details. -### 8. Changed: Tracking on localhost +### 8. Updated: Tracking on localhost If you were previously using `local` extension to track events on localhost, you will need to set `captureOnLocalhost` option to `true`: @@ -101,20 +99,20 @@ plausible.init({ }) ``` -### 9. Changed: Custom events and revenue features are automatically enabled +### 9. Simplified: Custom events and revenue features are automatically enabled -If you were already using these features, no additional steps are required. Documentation links: +If you were already using these features, no additional steps are required. See: - [Custom events](/custom-event-goals) - [Ecommerce revenue and attribution tracking](docs/ecommerce-revenue-tracking.md) -### 10. Removed: `data-exclude` +### 10. Removed: `data-exclude` and `data-include` The new script no longer supports the `data-exclude` and `data-include` attributes. See [alternative guide](/excluding.md) instead. ### 11. Removed: multiple domain support -The new script does not support sending stats to multiple dashboards at once anymore. Keep using the old script for this functionality. +The new script no longer supports sending stats to multiple dashboards simultaneously. Continue using the old script if you need this functionality. ## Google tag manager {#gtm} -If you've installed Google Tag Manager using previous instructions, you will need to delete the old tag and install us [using tag manager gallery](/docs/google-tag-manager.md). +If you previously installed Plausible through Google Tag Manager, remove the old tag and reinstall it [using tag manager gallery](/docs/google-tag-manager.md) instructions. From 1b1469d819754928a0cecf330e59f687372a89a5 Mon Sep 17 00:00:00 2001 From: Hricha Shandily <103104754+Hricha-Shandily@users.noreply.github.com> Date: Tue, 7 Oct 2025 14:37:22 +0530 Subject: [PATCH 2/4] Enhance form submission tracking section Added link to form submission tracking documentation. --- docs/script-update-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/script-update-guide.md b/docs/script-update-guide.md index 308bda76..8487a2c5 100644 --- a/docs/script-update-guide.md +++ b/docs/script-update-guide.md @@ -24,7 +24,7 @@ Each site now has its own snippet. This means you no longer need to update the s ### 2. New: Form submission tracking -You can now enable or disable form submission tracking directly from the **Site Installation** settings. +You can now enable or disable [form submission tracking](https://plausible.io/docs/form-submissions-tracking) directly from the **Site Installation** settings. ### 3. Updated: Custom properties From 6f3169b3d406f38acf7aa99406869c41d0941307 Mon Sep 17 00:00:00 2001 From: Hricha Shandily <103104754+Hricha-Shandily@users.noreply.github.com> Date: Tue, 7 Oct 2025 14:53:27 +0530 Subject: [PATCH 3/4] Enhance form submissions tracking documentation Updated the description of the form submissions tracking feature to clarify its functionality and analysis capabilities. --- docs/form-submissions-tracking.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/form-submissions-tracking.md b/docs/form-submissions-tracking.md index 563dfcb6..f8e432b8 100644 --- a/docs/form-submissions-tracking.md +++ b/docs/form-submissions-tracking.md @@ -8,7 +8,11 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; If you use the form submissions tracking feature, then these count towards your billable monthly pageviews. ::: -Plausible helps you automate tracking form submissions. With our "**Form submissions**" tracking you can: +Plausible can automatically detect and track when visitors submit forms on your website. This feature helps you measure engagement with contact forms, signup forms, and other key conversion points without adding custom code. + +When Form submissions tracking is enabled, Plausible automatically detects all forms across your site and records submissions as a single goal. This means you don’t need to configure individual goals for each form — Plausible handles it for you. + +All detected form submissions are grouped under one goal, and you can analyze where conversions happen by filtering results by page path or referrer. For example, if the same form appears on multiple pages, Plausible will show how many submissions occurred on each specific page. ## Enable "Form submissions" for your site @@ -35,4 +39,4 @@ Click on "**Form: Submission**" goal in the "**Goal Conversions**" report of you * Countries that submit forms * Devices (screen size, browser, OS) that click on forms -Click on a particular form URL to filter the dashboard by those submissions only and get the full overview of that specific URL. +To analyze a specific form, click on its URL to filter your dashboard by that form’s submissions. This gives you a complete overview of performance for that individual form. From e8400320a73bc735e5457fe9f19ecdf24789ac13 Mon Sep 17 00:00:00 2001 From: Hricha Shandily <103104754+Hricha-Shandily@users.noreply.github.com> Date: Tue, 7 Oct 2025 16:37:23 +0530 Subject: [PATCH 4/4] Update google-tag-manager.md --- docs/google-tag-manager.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/google-tag-manager.md b/docs/google-tag-manager.md index fe3ac567..223f7719 100644 --- a/docs/google-tag-manager.md +++ b/docs/google-tag-manager.md @@ -4,23 +4,23 @@ title: How to add the script to your site using Google Tag Manager import useBaseUrl from '@docusaurus/useBaseUrl'; -This document walks through how you can set up Plausible Analytics using Google Tag Manager. +This guide walks you through how to set up Plausible Analytics using Google Tag Manager (GTM). ## Google Tag Manager Template -In order to make the process easier, we have published a template that makes setting up Plausible Analytics with Google Tag Manager simple and code free. +To make setup easier, Plausible provides a ready-to-use Google Tag Manager template. This template allows you to install and configure Plausible Analytics directly in GTM—no coding required. -The simplest way to install the custom template is to locate it in the [Google Tag Manager template gallery](https://tagmanager.google.com/gallery/#/) where you can install it directly from your Google Tag Manager dashboard. Here's the direct link to the [Plausible Analytics GTM template](https://tagmanager.google.com/gallery/#/owners/plausible/templates/plausible-gtm-template). +You can find the template in the [Google Tag Manager template gallery](https://tagmanager.google.com/gallery/#/) where you can install it directly from your Google Tag Manager dashboard. Here's the direct link to the [Plausible Analytics GTM template](https://tagmanager.google.com/gallery/#/owners/plausible/templates/plausible-gtm-template). Plausible GTM Template -Once you’ve installed the template, you should create a new Tag that uses it. To do this: +Once you’ve installed the template, you should create a new Tag in GTM to start tracking. -* In the main Google Tag Manager dashboard, browse to "**Tags**" and click "**New**" to create a new tag +* In your Google Tag Manager dashboard, go to **Tags** and click **New**. Plausible GTM Template New Tag -* From the list of available tag templates, choose the Plausible Analytics tag template you just installed +* From the list of available tag templates, select the **Plausible Analytics** tag template you just installed. Plausible GTM Template New Tag Template @@ -32,7 +32,7 @@ Once you’ve installed the template, you should create a new Tag that uses it. Plausible GTM Template New Tag Script ID -* For the tag trigger, you should select "**All Pages**" - "**Page View**", which will ensure that Plausible will capture data on all pages +* For the tag trigger, you should select "**All Pages**" - "**Page View**", which will ensure that Plausible will capture data on all pages. Plausible GTM Template New Tag Trigger