Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/change-domain-name.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@ Here's how to change the domain name of a site in your Plausible account:

- Go to the **General** section of the [website settings](website-settings.md) in your Plausible account

- Click on the **Change domain** button in the **Site domain** section
- In the **Site details** area, click **Change** next to **Site domain**

<div class="browser">
<img alt="Change domain name in Plausible" src={useBaseUrl('img/v2/change-domain.webp')} />
<img alt="Change the site domain in Plausible site settings" src={useBaseUrl('img/v2/change-domain.png')} />
</div>

- Type in your new domain name. For example, if your new domain is `https://www.yourdomain.com`, enter `yourdomain.com` in the **Domain** field. Remove `https://` and `www.` from the URL.
Expand Down
8 changes: 4 additions & 4 deletions docs/file-downloads-tracking.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,10 @@ File downloads tracking is essential for many site owners and Plausible helps yo

## Enable "File downloads" for your site

You can enable **File downloads** as an optional measurement when adding a new site to your Plausible account. If the site has already been added to your account, you can control what data is collected in the **Site Installation** area of the **General** section in your [site settings](website-settings.md).
By default, **File downloads** is enabled when adding a new site to your Plausible account. You can enable or disable it by going to the **General** section of your [site settings](website-settings.md). In the **Tracking** area, use the **File downloads** toggle under **Default tracking**. Your changes take effect automatically without needing to update the snippet on your site.

<div class="browser">
<img alt="Enable outbound file downloads tracking during onboarding" src={useBaseUrl('img/onboarding-enable-file-downloads-tracking.png')} />
<img alt="Enable file download tracking in Plausible site settings" src={useBaseUrl('img/v2/enable-file-download-tracking.png')} />
</div>

After you enable file downloads tracking on your site, all the file downloads will start being tracked and will be displayed in the **Goals** tab of your Plausible Analytics dashboard. You'll see the **File Download** goal as soon as the first file download has been tracked.
Expand Down Expand Up @@ -80,10 +80,10 @@ Learn more about [effectively optimizing for file downloads](https://plausible.i

## Other automated goals

Plausible also offers automated tracking for [outbound link clicks](outbound-link-click-tracking.md) and [form submissions](form-submissions-tracking.md). These can be enabled from the "Site Installation" area in your site settings without any code changes. You can also track [404 error pages](error-pages-tracking-404.md) with a small snippet of code.
Plausible also offers automated tracking for [outbound link clicks](outbound-link-click-tracking.md) and [form submissions](form-submissions-tracking.md). These can be enabled under **Default tracking** in the **Tracking** area of your site settings without any code changes. You can also track [404 error pages](error-pages-tracking-404.md) with a small snippet of code.

## How to disable "File downloads" tracking for your site

You can control what data is collected in the **Site Installation** area of the **General** section in your [site settings](website-settings.md).
Go to the **General** section of your [site settings](website-settings.md). In the **Tracking** area, switch off **File downloads** under **Default tracking**. Your changes take effect automatically without needing to update the snippet on your site.

After you disable file downloads tracking, we will automatically remove the goal called `File Download` from your site.
9 changes: 5 additions & 4 deletions docs/form-submissions-tracking.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,14 @@ When Form submissions tracking is enabled, Plausible automatically detects all f

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.

**Form submissions** is an [optional enhanced measurement](script-extensions.md). If you want to track form submissions, here's how to enable it:

## Enable "Form submissions" for your site

You can enable **Form submissions** as an optional measurement when adding a new site to your Plausible account. If the site has already been added to your account, you can control what data is collected in the **Site Installation** area of the **General** section in your [site settings](website-settings.md).
By default, **Form submissions** is enabled when adding a new site to your Plausible account. You can enable or disable it by going to the **General** section of your [site settings](website-settings.md). In the **Tracking** area, use the **Form submissions** toggle under **Default tracking**. Your changes take effect automatically without needing to update the snippet on your site.

<!-- TODO -->
<div class="browser">
<img alt="Enable form submissions tracking during onboarding" src={useBaseUrl('img/plausible-analytics-automatic-form-submission.png')}/>
<img alt="Enable form submission tracking in Plausible site settings" src={useBaseUrl('img/v2/enable-form-submission-tracking.png')} />
</div>

After you enable form submissions tracking, we will automatically add a new goal called `Form: Submission` to your site.
Expand All @@ -42,4 +43,4 @@ To analyze a specific form, click on its URL to filter your dashboard by that fo

## Other automated goals

Plausible also offers automated tracking for [outbound link clicks](outbound-link-click-tracking.md) and [file downloads](file-downloads-tracking.md). These can be enabled from the "Site Installation" area in your site settings without any code changes. You can also track [404 error pages](error-pages-tracking-404.md) with a small snippet of code.
Plausible also offers automated tracking for [outbound link clicks](outbound-link-click-tracking.md) and [file downloads](file-downloads-tracking.md). These can be enabled under **Default tracking** in the **Tracking** area of your site settings without any code changes. You can also track [404 error pages](error-pages-tracking-404.md) with a small snippet of code.
4 changes: 2 additions & 2 deletions docs/general.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,12 @@ description: "Change the reporting timezone in Plausible Analytics so daily stat

import useBaseUrl from '@docusaurus/useBaseUrl';

Within the **General** section of your website settings you can change the timezone for your reports in the **Site timezone** field. This sets the day boundary of your reports regardless of where your traffic is coming from.
Within the **General** section of your website settings you can change the timezone for your reports in the **Reporting timezone** field under **Site details**. This sets the day boundary of your reports regardless of where your traffic is coming from.

For instance, if you select **(GMT+01:00) Amsterdam, Berlin…** then the beginning and the end of each day of your reporting is calculated based on the time in Amsterdam, even if your visitors come from London or New York.

The best practice is to set the timezone that reflects the location of your audience or if the audience is very broad and spread across the world to set the timezone of your location.

<div class="browser">
<img alt="Plausible Analytics" src={useBaseUrl('img/v2/reporting-timezone.webp')} />
<img alt="Change the reporting timezone in Plausible site settings" src={useBaseUrl('img/v2/reporting-timezone.png')} />
</div>
10 changes: 4 additions & 6 deletions docs/outbound-link-click-tracking.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,10 @@ Outbound link click tracking is essential for many site owners and Plausible hel

## Enable "Outbound links" for your site

By default, **Outbound links** is enabled when adding a new site to your Plausible account. If the site has already been added to your account, you can control what data is collected in the **Site Installation** area of the **General** section in your [site settings](website-settings.md).
By default, **Outbound links** is enabled when adding a new site to your Plausible account. You can enable or disable it by going to the **General** section of your [site settings](website-settings.md). In the **Tracking** area, use the **Outbound links** toggle under **Default tracking**. Your changes take effect automatically without needing to update the snippet on your site.

<div class="browser">
<img alt="Enable outbound link clicks tracking during onboarding" src={useBaseUrl('img/onboarding-enable-outbound-link-clicks-tracking.png')} />
<img alt="Enable outbound link tracking in Plausible site settings" src={useBaseUrl('img/v2/enable-outbound-link-tracking.png')} />
</div>

After you enable outbound link click tracking, we will automatically add a new goal called `Outbound Link: Click` to your site.
Expand Down Expand Up @@ -56,12 +56,10 @@ Check out this blog post for more details on the value of [tracking outbound lin

## Other automated goals

Plausible also offers automated tracking for [file downloads](file-downloads-tracking.md) and [form submissions](form-submissions-tracking.md). These can be enabled from the "Site Installation" area in your site settings without any code changes. You can also track [404 error pages](error-pages-tracking-404.md) with a small snippet of code.
Plausible also offers automated tracking for [file downloads](file-downloads-tracking.md) and [form submissions](form-submissions-tracking.md). These can be enabled under **Default tracking** in the **Tracking** area of your site settings without any code changes. You can also track [404 error pages](error-pages-tracking-404.md) with a small snippet of code.

## How to disable "Outbound links" tracking for your site

You can control what data is collected in the **Site Installation** area of the **General** section in your [site settings](website-settings.md).

When making changes to your optional measurements, your snippet will change so do ensure to insert the newest snippet into your site for outbound link click tracking to stop.
Go to the **General** section of your [site settings](website-settings.md). In the **Tracking** area, switch off **Outbound links** under **Default tracking**. Your changes take effect automatically without needing to update the snippet on your site.

After you disable outbound link click tracking, we will automatically remove the goal called `Outbound Link: Click` from your site.
4 changes: 2 additions & 2 deletions docs/plausible-script.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ To integrate your website with Plausible Analytics, you need to insert a Plausib

We display your snippet during the process of adding a new site to your account. For sites that you've already added to your account, you can find your JavaScript snippet by [the Sites page](https://plausible.io/sites), which lists all the websites you've added to Plausible.

Click on the menu icon on the right-hand side of the site you'd like to get the snippet for and choose **Settings** to enter the [site settings](website-settings.md). Then scroll down to the **Site Installation** area of the **General** section. Click on the **Review Installation** button to get the installation details including your snippet.
Click on the menu icon on the right-hand side of the site you'd like to get the snippet for and choose **Settings** to enter the [site settings](website-settings.md). In the **General** section, scroll down to the **Tracking** area and click **Review** next to **Site installation** to get the installation details including your snippet.

There you can also enable any [optional enhanced measurements](script-extensions.md).

Expand All @@ -22,7 +22,7 @@ There you can also enable any [optional enhanced measurements](script-extensions
/>

<div class="browser">
<img alt="Add script extensions and verify your installation" src={useBaseUrl('img/v2/add-script-extensions-verify-installation.webp')} />
<img alt="Review your Plausible installation and copy the tracking snippet" src={useBaseUrl('img/v2/add-script-extensions-verify-installation.webp')} />
</div>

:::tip Want to track visitors across your domain and its subdomains?
Expand Down
14 changes: 9 additions & 5 deletions docs/script-extensions.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,20 @@
---
title: Enable optional measurements
description: "Enable optional Plausible measurements for outbound links, file downloads, form submissions and more. Available during setup or later in your site settings."
description: "Enable optional Plausible measurements for outbound links, file downloads, form submissions and more from your site settings."
---

import useBaseUrl from '@docusaurus/useBaseUrl';

The Plausible script offers enhanced measurements and configuration options to tailor tracking to your needs.

You can enable optional measurements for form submissions, outbound link clicks and file downloads when adding a new site to your Plausible account, or later in the **Site installation** area under **General** in your [site settings](website-settings.md).
You can manage these optional measurements in the **Tracking** area under **General** in your [site settings](website-settings.md).

There are also additional measurement options that you can set up manually if needed.
Under **Default tracking**, you can enable or disable automatic tracking for outbound links, file downloads and form submissions. Your changes take effect automatically without needing to update the snippet on your site.

There are also additional tracking options that you can set up manually if needed. You can find links to their setup instructions by expanding **Additional tracking**.

<div class="browser">
<img alt="Enable optional enhanced measurements" src={useBaseUrl('img/v2/onboarding-enable-enhanced-tracking.webp')} />
<img alt="Manage default and additional tracking in Plausible site settings" src={useBaseUrl('img/v2/tracking-settings.png')} />
</div>

Here's the list of our optional measurements:
Expand All @@ -21,12 +23,14 @@ Here's the list of our optional measurements:

| Optional Measurement | Explanation |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Default tracking** | |
| Outbound links | Automatically [track clicks on outbound links](outbound-link-click-tracking.md) |
| File downloads | Automatically [track file downloads](file-downloads-tracking.md) |
| Form submissions | Automatically [track form submissions](form-submissions-tracking.md) |
| **Additional tracking** | |
| Custom event tracking | Allows you to [track custom events](custom-event-goals.md) such as link clicks, form submits and any other HTML element clicks |
| 404 error pages | Allows you to set up [404 error pages tracking](error-pages-tracking-404.md) |
| Hashed page paths | Allows you to set up page paths that use a `#` in the URL ([hash-based routing](hash-based-routing.md)) |
| Custom events | Allows you to [track custom events](custom-event-goals.md) such as link clicks, form submits and any other HTML element clicks |
| Custom properties | Allows you to attach [custom properties](/custom-props/introduction) (also known as custom dimensions in Google Analytics) when sending a pageview or custom event to create custom metrics |
| Ecommerce revenue | Allows you to assign dynamic [monetary values](ecommerce-revenue-tracking.md) to custom events and track revenue attribution |

Expand Down
2 changes: 1 addition & 1 deletion sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@ module.exports = {
'introduction',
'register-account',
'add-website',
'script-extensions',
'plausible-script',
'integration-guides',
'troubleshoot-integration',
Expand All @@ -15,6 +14,7 @@ module.exports = {
'website-settings',
'change-domain-name',
'general',
'script-extensions',
'visibility',
'shared-links',
'embed-dashboard',
Expand Down
Binary file added static/img/v2/change-domain.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/img/v2/change-domain.webp
Binary file not shown.
Binary file added static/img/v2/enable-file-download-tracking.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v2/enable-outbound-link-tracking.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/v2/reporting-timezone.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/img/v2/reporting-timezone.webp
Binary file not shown.
Binary file added static/img/v2/tracking-settings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading