Update hash-based-routing docs

macobo · macobo · commit 17ec3d921f38 · 2025-06-26T11:54:01.000+03:00
diff --git a/docs/hash-based-routing.md b/docs/hash-based-routing.md
@@ -4,10 +4,20 @@ title: Hashed page paths
 
 import useBaseUrl from '@docusaurus/useBaseUrl';
 
-If your site is using page paths with a `#` in the URL, you can use our "**Hashed page paths**" tracking to see the different pages your visitors have viewed.
+If your site is using page paths with a `#` in the URL, you can use our "**Hashed page paths**" tracking to see the different pages your visitors have viewed. Here's how to enable it:
 
-You can enable "**Hashed page paths**" tracking 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 how data is collected in the "**Site Installation**" area of the "**General**" section in your [site settings](website-settings.md).
+## Update your snippet
 
-<img alt="Enable hashed page paths tracking during onboarding" src={useBaseUrl('img/onboarding-enable-hash-based-tracking.png')} />
+We display your snippet during the process of adding a new site to your account. You can also see the snippet within the "**Site Installation**" area of the "**General** section in your [site settings](website-settings.md).
+
+Update the snippet to pass the following argument to `plausible.init`:
+
+```javascript
+plausible.init({
+  hashBasedRouting: true
+})
+```
+
+Your Plausible tracking snippet should be inserted into [the Header (`<head>`) section of your site](plausible-script.md). Place the tracking script within the `<head> … </head>` tags.
 
 After you change the tracking snippet on your site, all the hash-based page paths will start being tracked and will be displayed in the "**Top Pages**" report of your Plausible Analytics dashboard.
diff --git a/docs/script-update-guide.md b/docs/script-update-guide.md
@@ -67,7 +67,19 @@ 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
 
-### 6. Changed: Tracking pageviews manually
+### 6. Changed: 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:
+
+```javascript
+plausible.init({
+  hashBasedRouting: true
+})
+```
+
+See also [Hashed page paths guide](/hash-based-routing.md)
+
+### 7. Changed: Tracking pageviews manually
 
 If you were previously using the `manual` extension to track pageviews manually, you will need to set `autoCapturePageviews` option to `false`:
 
@@ -79,7 +91,7 @@ plausible.init({
 
 See also [Custom locations guide](/custom-locations).
 
-### 7. Changed: Tracking on localhost
+### 8. Changed: Tracking on localhost
 
 If you were previously using `local` extension to track events on localhost, you will need to set `captureOnLocalhost` option to `true`:
 
@@ -89,16 +101,16 @@ plausible.init({
 })
 ```
 
-### 8. Changed: Custom events and revenue features are automatically enabled
+### 9. Changed: Custom events and revenue features are automatically enabled
 
 If you were already using these features, no additional steps are required. Documentation links:
 - [Custom events](/custom-event-goals)
 - [Ecommerce revenue and attribution tracking](docs/ecommerce-revenue-tracking.md)
 
-### 9. Removed: `data-exclude`
+### 10. Removed: `data-exclude`
 
 The new script no longer supports the `data-exclude` and `data-include` attributes. See [alternative guide](/excluding.md) instead.
 
-### 10. Removed: multiple domain support
+### 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.
diff --git a/static/img/onboarding-enable-hash-based-tracking.png b/static/img/onboarding-enable-hash-based-tracking.png
