scroll depth

docs/google-analytics-import.md

@@ -92,7 +92,11 @@ We can import your traffic split between the different browsers but you can't dr
 
 ### Exit pages
 
-Google Analytics 4 API does not expose this information so you cannot see the Exit Pages report for imported data. 
+Google Analytics API does not expose this information so you cannot see the Exit Pages report for imported data. 
+
+### Scroll Depth
+
+Google Analytics API does not expose this information so you cannot see the scroll depth metric for imported data. 
 
 ### Day view graph
 

docs/guided-tour.md

@@ -62,7 +62,7 @@ You can also use the "**Filter**" button on the top of your dashboard which give
 
 ## Detailed metrics and Sorting
 
-You can click the "**Details**" button at the bottom of any report to get an expanded view and see the full list with additional metrics such as Visitors, Bounce Rate, Visit Duration, Uniques, Total, CR (Conversion Rate), etc., depending upon the type of the report.
+You can click the "**Details**" button at the bottom of any report to get an expanded view and see the full list with additional metrics such as "**Visitors**", "**Bounce Rate**", "**Visit Duration**", "**Scroll Depth**", "**Unique Conversions**", "**Total Conversions**", "**Conversion Rate**" and more all depending upon the type of the report.
 
 You can sort any report by such performance metrics by clicking on any metric heading to sort and arrange your data in ascending or descending order.
 
@@ -78,7 +78,7 @@ Note that the referral sources including UTM and other query parameters are coun
 
 ## Top Pages
 
-See all the most visited pages on your site ranked by the number of unique visitors. You can click on the "**details**" button to see the full list with additional metrics. The number of pageviews, bounce rate, and time on page for the individual pages are included too.
+See all the most visited pages on your site ranked by the number of unique visitors. You can click on the "**details**" button to see the full list with additional metrics. The number of pageviews, bounce rate, time on page and scroll depth for the individual pages are included too.
 
 You can also get insights into the visitor flow by looking at the "**Entry pages**" and "**Exit pages**". Click on the "**details**" button to see the full list with additional metrics. For "**Entry pages**" details include visit duration for visits that started on a specific page and for "**Exit pages**" details include the exit rate percentage. [Read more here](top-pages.md).
 

docs/metrics-definitions.md

@@ -87,6 +87,10 @@ You can click on any source to drill-down and view the individual pages linking
 
 Shows the devices used by your visitors. Devices are categorized into desktop, mobile or tablet. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. Metrics are shown as the total number of unique visitors and as a percentage of all visitors.
 
+## Scroll Depth
+
+Measures how far visitors scroll down a webpage. It represents the percentage of a page’s total height that visitors have reached on average. ```
+
 ## Source
 
 See all referral sources that are sending you traffic. A source is reported when a person clicks through to your site from another site.

docs/pageview-goals.md

@@ -14,13 +14,17 @@ To get started with "**Pageview Goals**", go to [your website's settings](websit
 
 <img alt="Add your first goal" src={useBaseUrl('img/goal-conversions.png')} />
 
-Click on the "**+ Add goal**" button to go to the goal creation form.
+Click the "**+ Add goal**" button to go to the goal creation form.
 
-Select `Pageview` as the goal trigger and enter the pathname of the page you would like your visitors to hit. The pathname must match the page path you can see in your Plausible Analytics dashboard.
+Select `Pageview` as the goal trigger and enter the pathname of the page you would like your visitors to hit, or select the same from the dropdown. The pathname must match the page path you can see in your Plausible Analytics dashboard.
 
 <img alt="Add your pageview goal" src={useBaseUrl('img/add-pageview-goal.png')} />
 
-Next, click on the "**Add goal**" button and you’ll be taken back to the goals page. When you navigate back to your Plausible Analytics dashboard, you should see the number of visitors who reached the specified page or group of pages. Goal conversions are listed at the very bottom of the dashboard.
+Next, you'll see the Display Name which gets self-populated. You can optionally edit it. You can also edit this later at any time. 
+
+In the next field, you can optionally choose a scroll depth threshold for the selected page to see how many visitors scroll below your desired scroll depth mark. Scroll depth is measured in percentage of a page’s total height that visitors have reached on average. If you set this up, you can filter and break down page scroll goals like any other goals on the dashboard.
+
+Then click the "**Add goal**" button and you’ll be taken back to the goals page. When you navigate back to your Plausible Analytics dashboard, you should see the number of visitors who reached the specified page or group of pages. Goal conversions are listed at the very bottom of the dashboard.
 
 ## How to group your pages
 

docs/scroll-depth.md

@@ -0,0 +1,41 @@
+---
+title: Scroll depth tracking
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+Scroll depth tracking is built into Plausible Analytics by default, allowing you to measure how far visitors scroll down your pages, expressed as a percentage.
+
+This data provides insights into user engagement and helps optimize content placement, calls-to-action (CTAs), and page layouts.
+
+## How scroll depth tracking works in Plausible
+
+### Measured at all depths
+
+Plausible tracks scrolling at all percentages (1% to 100%), unlike many other tools that limit tracking to specific points such as 25%, 50%, and 75%.
+
+### Available with the pages data
+
+You can find scroll depth data in:
+
+1.  **The top row of metrics** when a page filter is applied. Click on it to see trends over time.
+
+2.  **The expanded Top Pages report**, where pages can be sorted by scroll depth for deeper analysis.
+
+<img alt="Scroll depth metric in Plausible" src={useBaseUrl('img/scroll-depth.png')} />
+
+If there's insufficient data, scroll depth will display as "-" until more traffic is recorded.
+
+You can also use the Filters feature to group similar pages and analyze their average scroll depth. For example, filter URLs containing "blog" to see average engagement for blog posts.
+
+### How we calculate scroll depth
+
+Scroll depth is calculated as the maximum scroll depth reached by an average user on a specific page. For example, if a user visits a page multiple times and scrolls to different depths (25%, 60%, 10%), their maximum depth is 60%. The final value is based on the maximum average depth of all users.
+
+## Page scroll goals
+
+You can also define a `scroll_threshold` when creating a [pageview goal](https://plausible.io/docs/pageview-goals) to see how many visitors scroll below your desired scroll depth mark.
+
+Once set up, you will be able to filter and break down page scroll goals like any other goals on the dashboard.
+
+If you'd like to learn more about what scroll depth is, what's a good metric to have, and more, you can check out our blog post [here](https://plausible.io/blog/scroll-depth-tracking).

docs/top-pages.md

@@ -4,7 +4,7 @@ title: Top content, landing pages and exit pages
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-Your "**Top Pages**" report shows which pages your visitors are visiting the most often. You can use it to identify the most popular content on your site. Click on any page to segment your audience by those who visited that particular page. You can also click the "**Details**" button to see the full list of pages with additional metrics. The number of pageviews, bounce rate, and time on page for the individual pages are included too. Click on any metric heading to sort and arrange your data in ascending or descending order.
+Your "**Top Pages**" report shows which pages your visitors are visiting the most often. You can use it to identify the most popular content on your site. Click on any page to segment your audience by those who visited that particular page. You can also click the "**Details**" button to see the full list of pages with additional metrics. The number of pageviews, bounce rate, time on page and scroll depth for the individual pages are included too. Click on any metric heading to sort and arrange your data in ascending or descending order.
 
 You can also see the traffic flow by looking at the "**Entry Pages**" and "**Exit Pages**" reports. You can click the "**Details**" button to see the full list with additional details. For entry pages, details include visit duration for visits that started on a specific page and for exit pages, details include the exit rate percentage. Click on any metric heading to sort and arrange your data in ascending or descending order.
 

sidebars.js

@@ -37,6 +37,7 @@ module.exports = {
       'top-pages',
       'countries',
       'devices',
+      'scroll-depth',
       'subdomain-hostname-filter',
       'metrics-definitions',
       'keyboard-shortcuts',