metmarkosaric · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026
diff --git a/docs/csv-import.md b/docs/csv-import.md
@@ -27,10 +27,10 @@ Here's how you can import your historical stats into your Plausible dashboard by
 
 1. Go to the Plausible Analytics [site settings](website-settings.md) for the website you'd like to import the data to.
 
-2. Go into the **Imports & Exports** section, find the **Import Data** panel and click on the **CSV** button to import your CSV files.
+2. Go into the **Imports & Exports** section, find the **Import Data** panel and click on **Import from CSV** to import your CSV files.
 
 <div class="browser">
-<img alt="Import CSV" src={useBaseUrl('img/import-csv.png')} />
+<img alt="Import from CSV button in the Import data panel under Plausible site settings, Imports & Exports" src={useBaseUrl('img/import-csv.png')} />
 </div>
 
 3. Select all the CSV files that you'd like to import and click on the **Confirm import** button. When importing your stats from different analytics tools, please ensure that each CSV file follows our CSV format guidelines. The guidelines are listed at the end of this document.
@@ -45,7 +45,7 @@ To [transfer site ownership](transfer-ownership.md) to another account, or to [c
 
 2. Go into the **Imports & Exports** section, find the **Export Data** panel and click on the **Export to CSV** button to export all the data. Note that only native data can be exported. Any data imported from external sources such as Google Analytics will be excluded from the export.
 
-3. Then go to the site you'd like to import the data to. In the **Imports & Exports** section, find the **Import Data** panel and click on the **CSV** button to import your CSV files.
+3. Then go to the site you'd like to import the data to. In the **Imports & Exports** section, find the **Import Data** panel and click on **Import from CSV** to import your CSV files.
 
 4. Make sure to select all the CSV files that you've exported and click on the **Confirm import** button. If you don't select all the exported files, some data may be missing from your import.
 
@@ -87,8 +87,8 @@ There are several exceptions to this though, because some properties are aggrega
 
 By default, imported data is always included in the view, unless you choose to exclude it manually by opening the options menu (the **⋮** icon in the top right of the chart) and toggling off **Include imported data**.
 
-<div class="browser">
-<img alt="Stats include imported data" src={useBaseUrl('img/stats-include-imported-data.png')} />
+<div class="browser screenshot-padded" style={{maxWidth: '265px'}}>
+<img alt="Plausible dashboard options with Include imported data switched on" src={useBaseUrl('img/plausible-include-imported-data.webp')} width="245" height="253" loading="lazy" decoding="async" />
 </div>
 
 Whenever imported data cannot be included due to the applied filters, you will see a warning bubble stating “Imported data is excluded due to applied filters” in the corresponding report. Note that this does not affect displaying native data in any way.

diff --git a/docs/dashboard-faq.md b/docs/dashboard-faq.md
@@ -7,10 +7,10 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 
 ## Numbers not 'adding up'
 
-It's common to see that the numbers in your dashboard aren't _adding up_. In the example below, there are 27 unique users in total but when you add together the unique users in the **Top Pages** tab, it adds up to 53 users.
+It's common to see that the numbers in your dashboard aren't _adding up_. The **Unique visitors** metric counts each visitor once for the selected period. The **Top Pages** report counts visitors separately for each page, so someone who visits several pages appears in several rows. Adding those rows can therefore give a higher number than the dashboard's total unique visitors.
 
-<div class="browser">
-<img alt="Numbers not adding up" src={useBaseUrl('img/numbers-not-adding-up.png')} />
+<div class="browser screenshot-padded">
+<img alt="Plausible dashboard with total unique visitors above a Top Pages report listing visitors for each page" src={useBaseUrl('img/plausible-unique-visitors-by-page.webp')} width="1088" height="981" loading="lazy" decoding="async" />
 </div>
 
 This happens because visitors can view more than a single page or trigger more than a single custom event on your site. Imagine a single visitor triggering two pageviews: `/page1` and `/page2`. In this case your Plausible dashboard would show 1 unique visitor in total. However, the **Top Pages** tab would show one unique visitor for `/page1` and one unique visitor for `/page2`.

diff --git a/docs/error-pages-tracking-404.md b/docs/error-pages-tracking-404.md
@@ -38,7 +38,7 @@ description: "Find broken links and missing pages on your site. Add a small code
           "name": "Where do I see which 404 pages are being visited?",
           "acceptedAnswer": {
             "@type": "Answer",
-            "text": "After setting up the 404 goal, open your Plausible dashboard and filter by the '404' goal. The Top Pages report shows which URLs are generating the most 404 visits. Click any URL to filter the dashboard by that specific page."
+            "text": "After setting up the 404 goal, open your Plausible dashboard and filter by the '404' goal. The 404 Pages report shows which paths are generating the most 404 visits. Click any URL to filter the dashboard by that specific page."
           }
         }
       ]
@@ -49,7 +49,7 @@ description: "Find broken links and missing pages on your site. Add a small code
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
 <div class="browser">
-<img alt="How to track 404 error pages" src={useBaseUrl('img/track-404-error-pages.png')} />
+<img alt="Plausible 404 Pages report listing missing page paths with visitor counts, event counts and conversion rates" src={useBaseUrl('img/track-404-error-pages.png')} />
 </div>
 
 :::note
@@ -80,12 +80,12 @@ You can place this code anywhere in the `<head>` or `<body>` section of your 404
 
 To configure a goal, go to [your website's settings](website-settings.md) in your Plausible account and visit the **Goals** section. You should see a list of current goals with a prompt to add a goal.
 
-Click on the **+ Add goal** button to go to the goal creation form.
+Click **Add goal**, then select **Custom event** to open the goal creation form.
 
-Select `Custom event` as the goal trigger and enter `404` as the name of the custom event you are triggering. The 404 goal works the same way as any other [custom event goal](custom-event-goals.md).
+Enter `404` in **Event name** and select it from the dropdown. Keep **Display name** as `404`. The 404 goal works the same way as any other [custom event goal](custom-event-goals.md).
 
-<div class="browser">
-<img alt="Add your first goal" src={useBaseUrl('img/goal-conversions.png')} />
+<div class="browser screenshot-padded" style={{maxWidth: '480px'}}>
+  <img alt="Create a 404 custom event goal in Plausible with Event name and Display name both set to 404" src={useBaseUrl('img/plausible-create-404-goal.webp')} width="896" height="1048" loading="lazy" decoding="async" />
 </div>
 
 After clicking on the **Add goal** button, the goal will be created and you'll be taken back to the Goals page.
@@ -128,7 +128,7 @@ Every 404 visit is a visitor who landed somewhere broken. The impact depends on
 
 ## Analyzing and acting on 404 data
 
-Once you have the 404 goal set up, open your Plausible dashboard and filter by the `404` goal. The Top Pages report will show which URLs are generating the most 404 visits.
+Once you have the 404 goal set up, open your Plausible dashboard and filter by the `404` goal. The **404 Pages** report will show which paths are generating the most 404 visits.
 
 **Prioritize by volume.** A URL generating 50 visits per month is worth fixing. One generating one visit per year is not.
 

diff --git a/docs/export-stats.md b/docs/export-stats.md
@@ -29,8 +29,8 @@ You can export your stats directly from the top chart of your Plausible dashboar
 3. If applicable, open the options menu (the **⋮** icon in the top right of the chart) and toggle **Include imported data** to choose whether you want your imported data to be included in the export
 4. Then open the options menu and click **Export stats** to download the stats for your chosen view and segment
 
-<div class="browser">
-<img alt="Exporting your website stats" src={useBaseUrl('img/v2/export-website-stats.webp')} />
+<div class="browser screenshot-padded">
+<img alt="Plausible dashboard options menu with the Export stats button" src={useBaseUrl('img/plausible-export-dashboard-stats.webp')} width="1088" height="531" loading="lazy" decoding="async" />
 </div>
 
 This will export a ZIP file which includes CSV files of the individual reports. You can then use these CSV files to import your stats into Excel or other data analysis tools.

diff --git a/docs/filters-segments.md b/docs/filters-segments.md
@@ -26,8 +26,8 @@ You can remove all your filters by hitting the `Esc` key on your keyboard or by
 
 ## Use the "Filter" button for more powerful segmenting and matching
 
-<div class="browser">
-    <img alt="Using the custom filter" src={useBaseUrl('img/v2/custom-filter.webp')} />
+<div class="browser screenshot-padded">
+    <img alt="Plausible Filter menu with segments, pages, sources, locations, devices, goals and custom properties" src={useBaseUrl('img/v2/custom-filter.webp')} width="1088" height="531" loading="lazy" decoding="async" />
 </div>
 
 When you’re trying to understand and analyze your traffic, the **Filter** button gives you more control. Click it and choose a dimension such as **Page**, **Source**, **Location** or **Goal**. Some dimensions are grouped in submenus. For example, **Page** contains **Page**, **Entry page** and **Exit page**.
@@ -42,10 +42,10 @@ You can filter your stats by multiple sources, countries, pages and more, all at
 
 ### Search for any metric
 
-You can search for any metric such as a particular country, referral source or page on your site. Start typing to discover the specific page (or another metric) you're looking for. No need to scroll through the long list of countries or pages.
+After choosing a filter dimension, type in its search field to find a particular country, referral source or page on your site. Select the matching values you want to include, then click **Done**. You can select multiple values without scrolling through the full list.
 
 <div class="browser">
-    <img alt="Search for any metric" src={useBaseUrl('img/v2/filter-typing.webp')} />
+    <img alt="Page filter search for dashboard, with matching page paths and checkboxes for selecting multiple pages" src={useBaseUrl('img/v2/filter-typing.webp')} />
 </div>
 
 ### Exclude specific segments of traffic
@@ -77,7 +77,7 @@ Learn more on how Plausible [handles cross-subdomain tracking here](subdomain-ho
 Click on any metric in the dashboard or use the **Filter** button to filter your audience to a desired segment. After completing your segment, click the **Save as segment** (star icon) option next to the filter pills.
 
 <div class="browser">
-    <img alt="Save filtered dashboard as a segment" src={useBaseUrl('img/save-filtered-dashboard-as-segment.png')} />
+    <img alt="Save as segment star button beside the active Entry page and Channel filters" src={useBaseUrl('img/save-filtered-dashboard-as-segment.png')} />
 </div>
 
 Segments can be saved either as "personal segments" (these are visible only to you) or as "site segments" (these are visible to all the team members that have access to your dashboard).
@@ -89,7 +89,7 @@ Choose the type of segment you want to create, give it a recognizable name and c
 Click the **Filter** button and open **Segment** to view your saved segments. Click on a segment to open it in your dashboard.
 
 <div class="browser">
-    <img alt="Open a Segment" src={useBaseUrl('img/v2/open-segments.webp')} />
+    <img alt="Saved segments listed in the Segment submenu of the Plausible Filter menu" src={useBaseUrl('img/v2/open-segments.webp')} />
 </div>
 
 The **Segment** entry is only visible after you save your first segment.

diff --git a/docs/guided-tour.md b/docs/guided-tour.md
@@ -11,8 +11,8 @@ Here’s what you can discover on your Plausible dashboard. You can also explore
 
 ## Top Graph
 
-<div class="browser">
-    <img alt="Plausible Analytics top graph showing unique visitors, total visits, pageviews, bounce rate and visit duration" src={useBaseUrl('img/v2/top-graph.webp')} />
+<div class="browser screenshot-padded">
+    <img alt="Plausible Analytics overview graph with visitors, visits, pageviews, views per visit, bounce rate and visit duration" src={useBaseUrl('img/v2/top-graph.webp')} width="1088" height="531" loading="lazy" decoding="async" />
 </div>
 
 See the number of unique visitors, total visits (sessions), total page views, views per visit, the bounce rate (the percentage of sessions that had one page view only) and the visit duration. You can **click on a particular metric to display it in the top graph**.
@@ -29,10 +29,10 @@ You can also **add annotations** to the chart to mark important events like a de
 
 ## Set a different chart interval
 
-You can **set a different unit of time the stats on the chart are grouped by** in the options menu (the **⋮** icon in the top right of the chart). Click it and select **Graph interval**. The available interval options depend on the date range you've selected. For example, if you select "Today", you can display the stats by minute or by hour.
+You can **set a different unit of time the stats on the chart are grouped by** in the options menu (the **⋮** icon in the top right of the chart). Open the menu and choose an option under **Graph interval**. The available interval options depend on the date range you've selected. For example, if you select "Today", you can display the stats by minute or by hour.
 
-<div class="browser">
-    <img alt="Plausible Analytics graph interval options for Today view showing minute and hour groupings" src={useBaseUrl('img/v2/chart-interval.webp')} />
+<div class="browser screenshot-padded">
+    <img alt="Plausible graph interval menu showing minute and hour groupings for a single day" src={useBaseUrl('img/v2/chart-interval.webp')} width="1088" height="531" loading="lazy" decoding="async" />
 </div>
 
 Or if you select "Last 28 days", you can display the stats by day or by week. You can display the stats by days, weeks or months if you choose a wider timeframe.

diff --git a/docs/reset-site-data.md b/docs/reset-site-data.md
@@ -5,8 +5,10 @@ description: "How to reset all collected stats for a site in Plausible Analytics
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-Within the **Danger zone** section of [your website settings](website-settings.md) you can reset your website stats. This removes all the stats you've collected until that point. Click on the **Reset** button to reset your stats from Plausible Analytics.
+Within the **Danger zone** section of [your website settings](website-settings.md), find **Reset stats** and click **Reset [your domain] stats**. Confirm the reset when prompted.
 
-<div class="browser">
-<img alt="Reset your site data" src={useBaseUrl('img/reset-website-data-plausible-analytics.png')} />
+<div class="browser screenshot-padded">
+  <img alt="Plausible site settings: Reset stats removes collected analytics while keeping the site configuration" src={useBaseUrl('img/plausible-reset-stats.webp')} width="1622" height="340" decoding="async" />
 </div>
+
+This permanently removes all the stats you've collected until that point while keeping the site and its configuration in your account. The separate **Delete site** action removes both the stats and the site settings.
diff --git a/docs/scroll-depth.md b/docs/scroll-depth.md
@@ -13,16 +13,16 @@ This data provides insights into user engagement and helps optimize content plac
 
 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.
+1.  **The top row of metrics** when a page filter is applied. Click a page in **Top Pages**, then click the **Scroll depth** metric above the graph to see scroll depth trends over time.
 
-<div class="browser">
-<img alt="Scroll depth metric in Plausible" src={useBaseUrl('img/scroll-depth-top-graph.png')} />
+<div class="browser screenshot-padded">
+<img alt="Scroll depth and time on page in the Plausible dashboard filtered to a single page" src={useBaseUrl('img/scroll-depth-top-graph.webp')} width="1088" height="531" loading="lazy" decoding="async" />
 </div>
 
-2.  **The expanded Top Pages tab**, where pages can be sorted by scroll depth for deeper analysis.
+2.  **The expanded Top Pages tab**. Click the expand icon in the top right of the report, then click the **Scroll depth** column heading to sort pages by their scroll depth.
 
-<div class="browser">
-<img alt="Scroll depth metric in Top Pages details" src={useBaseUrl('img/scroll-depth-top-pages-details.png')} />
+<div class="browser screenshot-padded">
+<img alt="Plausible Top Pages report showing scroll depth percentages alongside visitors, pageviews, bounce rate and time on page" src={useBaseUrl('img/plausible-scroll-depth-pages.webp')} width="880" height="618" loading="lazy" decoding="async" />
 </div>
 
 If there's insufficient data, scroll depth will display as "-" until more traffic is recorded.
@@ -44,7 +44,7 @@ Select `Scroll Depth` as the goal trigger, select the scroll depth percentage th
 When creating a scroll depth goal, you can optionally narrow it down using custom properties. This lets you turn a broad goal into a more specific one by matching only events with certain property values. For example, you could create a 75% scroll depth goal for blog posts that only counts when author = jane_doe, letting you measure deep engagement specifically with that author’s content.
 
 <div class="browser">
-<img alt="Scroll depth goals" src={useBaseUrl('img/scroll-depth-goal.png')} />
+<img alt="Add goal form with a 90% scroll threshold for /blog/remove-google-analytics and an optional custom property" src={useBaseUrl('img/scroll-depth-goal.png')} />
 </div>
 
 Do you want to analyze the scroll depth for a specific section of your site? You can use an asterisk (`*`) to match patterns in your page path URLs. Asterisks can be placed on either end or in the middle of any page path URL.