diff --git a/docs/carrd-integration.md b/docs/carrd-integration.md
index 229ca2f8..fa8228e7 100644
--- a/docs/carrd-integration.md
+++ b/docs/carrd-integration.md
@@ -37,13 +37,15 @@ We display your snippet during the process of adding a new site to your account.
* Then paste your Plausible tracking script in the **Code** field
-* In the snippet, update `plausible.init()` to `plausible.init({ hashBasedRouting: true })`. This allows plausible to track hashed page paths that Carrd uses during navigation.
+* In your copied snippet, set `hashBasedRouting` to `true` in the `plausible.init()` call. Keep the rest of your snippet, including its site-specific script URL, unchanged:
-* Do click on the **Done** button and then **Publish** your changes. After you change the tracking snippet on your site, all the hash-based page paths on your Carrd website will start being tracked and will be displayed in the **Top Pages** tab of your Plausible Analytics dashboard.
+```js
+plausible.init({ hashBasedRouting: true });
+```
-
-
})
-
+If your `plausible.init()` call already contains other options, keep them and add `hashBasedRouting: true`. This allows Plausible to track hashed page paths that Carrd uses during navigation.
+
+* Do click on the **Done** button and then **Publish** your changes. After you change the tracking snippet on your site, all the hash-based page paths on your Carrd website will start being tracked and will be displayed in the **Top Pages** tab of your Plausible Analytics dashboard.
Now you can go to your Carrd website and verify that Plausible script has been added and to your Plausible account to see whether the stats are being tracked. See here [how to verify the integration](troubleshoot-integration.md).
@@ -71,6 +73,8 @@ To be sure of your element's ID, you can use your browser's dev tool to inspect
### 2. Trigger custom events with JavaScript on your site
+Keep your [current Plausible tracking snippet](plausible-script.md) installed. Add the code below alongside it; it does not replace your tracking snippet.
+
Here's the code you will need to insert in the `` section of the page where the element ID that you want to track is located. You can use the **Custom Code** feature to do this similarly to how you've inserted the Plausible snippet into your site.
Make sure to change the `elementId` line in the code below to include the ID attribute of the element you want to track (`buttons01` in our example).
@@ -97,11 +101,7 @@ Also do change the `classes` line to include the goal name in this format: `plau
```
-
-
})
-
-
-Do click on the **Save Changes** button and then **Publish** your changes.
+Click **Done**, then **Publish** your changes.
### 3. Create a custom event goal in your Plausible account
@@ -147,10 +147,6 @@ If you want to trigger multiple custom events on the same site, you don't need t
```
-
-
})
-
-
## What's next?
- [Create goals](custom-event-goals.md) in your Plausible site settings to match the custom events you set up. They won't appear in your dashboard until you do
diff --git a/docs/ghost-integration.md b/docs/ghost-integration.md
index 630b20a6..ea21cda1 100644
--- a/docs/ghost-integration.md
+++ b/docs/ghost-integration.md
@@ -18,13 +18,9 @@ In Ghost you can inject code across your entire site or on an individual post or
linkText="Start free trial"
/>
-* In the **Menu**, click **Settings**, and then **Code Injection**.
+* In Ghost Admin, open **Settings → Advanced → Code Injection**. You can also follow [Ghost's current code injection guide](https://ghost.org/help/code-injection-styles/).
-
-
})
-
-
-* Add your Plausible Analytics script to the **Site Header** text box. Code added into the **Site Header** field is injected into the `` tag on every page of your site.
+* Paste your [Plausible tracking snippet](plausible-script.md) to the **Site Header** text box. Code added into the **Site Header** field is injected into the `` tag on every page of your site.
* After adding your code, click on the **Save** button.
@@ -38,7 +34,7 @@ The Sign In/Sign up flows are part of Ghost's [Portal](https://ghost.org/help/se
However, you can bypass this and customize your sign up flows by using a custom theme on the "[Creator plan](https://ghost.org/pricing/)" or higher.
-If you're using a custom theme, you can simply add the tagged events extension to your script and CSS class to the element that you want to track as explained in [this doc](https://plausible.io/docs/custom-event-goals).
+If you're using a custom theme, you can keep your Plausible tracking snippet installed and add the event CSS class to the element that you want to track as explained in [this doc](https://plausible.io/docs/custom-event-goals).
## What's next?
diff --git a/docs/google-search-console-integration.md b/docs/google-search-console-integration.md
index 5fb3d628..fa9c680c 100644
--- a/docs/google-search-console-integration.md
+++ b/docs/google-search-console-integration.md
@@ -115,11 +115,7 @@ Google samples its keyword data heavily. The sampling is why your keyword visito
## Plausible Analytics will be listed in your Google account settings
-You can check if Plausible Analytics is integrated with and has the right permissions to your Search Console properties in your Google account within the section **Apps with access to your account**. Here's the [direct link to that section](https://myaccount.google.com/permissions). Here's how it looks.
-
-
-
})
-
+Open your Google Account's [connections page](https://myaccount.google.com/connections) and select **Plausible Analytics**. Under the section describing Plausible's access to your Google Account, open **See details** to review its Search Console permissions. Google's [linked-apps guide](https://support.google.com/accounts/answer/13533235) explains how to review or remove access.
## Remove the Google Search Console integration
diff --git a/docs/shopify-integration.md b/docs/shopify-integration.md
index e056dd95..1095660f 100644
--- a/docs/shopify-integration.md
+++ b/docs/shopify-integration.md
@@ -286,6 +286,8 @@ Your form or button element should have an ID attribute assigned by default. You
### 2. Trigger custom events with JavaScript on your site
+Keep your [current Plausible tracking snippet](plausible-script.md) installed. Add the code below alongside it; it does not replace your tracking snippet.
+
Here's the code you will need to insert in the `` section of the page where the element ID that you want to track is located. You can do this the same way as you've inserted the Plausible snippet into your site.
Make sure to change the `elementId` line in the code below to include the ID attribute of the element you want to track (`ContactForm` in our example).
@@ -316,9 +318,6 @@ To represent a space character in goal names, you can use a `+` sign. For exampl
```
-
-
})
-
Do click on the **Save** button to save your changes.
@@ -366,9 +365,6 @@ If you want to trigger multiple custom events on the same site, you don't need t
```
-
-
})
-
## What's next?
diff --git a/docs/squarespace-integration.md b/docs/squarespace-integration.md
index d14e3c15..dcc0af8f 100644
--- a/docs/squarespace-integration.md
+++ b/docs/squarespace-integration.md
@@ -18,9 +18,9 @@ Here's how to add Plausible Analytics to your Squarespace site
## How to add Plausible to your Squarespace website
-* On your site's settings page, click on **Advanced** and then click on **Code Injection**
+* Open the **Code Injection** panel for your site. See [Squarespace's code injection guide](https://support.squarespace.com/hc/en-us/articles/205815908-Customize-parts-of-your-site-with-code-injection) for the navigation for your site version.
-* You can use the **[Custom Code](https://university.Squarespace.com/lesson/custom-code-in-the-head-and-body-tags)** feature in Squarespace to add Plausible tracking code to your website. Site-wide JavaScript code injection is a premium Squarespace feature so you need to upgrade your Squarespace account to a paid subscription plan.
+* You can use the **[Custom Code](https://support.squarespace.com/hc/en-us/articles/205815908-Customize-parts-of-your-site-with-code-injection)** feature in Squarespace to add Plausible tracking code to your website. Site-wide JavaScript code injection is a premium Squarespace feature so you need to upgrade your Squarespace account to a paid subscription plan.
* [Paste your Plausible snippet](https://plausible.io/docs/plausible-script) in the **Header Code** section. 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).
@@ -54,15 +54,9 @@ The easiest way to track form submissions on your Squarespace site is to track t
-* In the "Content" section, click on "Post-submit". Make sure you select the "Redirect" option and in the "Redirect URL" field type in the path to the thank you page ( i.e. **/thank-you** ).
+* In the **Content** tab, open **Edit Post-Submit**, choose **Redirect**, then click **Attach Link**. Select your thank-you page or enter its URL, then click **Save**. See [Squarespace's form block guide](https://support.squarespace.com/hc/en-us/articles/206566737-Form-blocks) for the current controls.
-
-
})
-
-
-
-
})
-
+Test the redirect while logged out of Squarespace or in a private browser window. Post-submit redirects do not work while you are logged into your site.
### 3. Create a pageview goal in your Plausible account
diff --git a/docs/webflow-integration.md b/docs/webflow-integration.md
index 99aeecb1..59a3daed 100644
--- a/docs/webflow-integration.md
+++ b/docs/webflow-integration.md
@@ -6,7 +6,6 @@ description: "Add Plausible Analytics to Webflow via Custom Code and track butto
---
import CtaBox from '@site/src/components/CtaBox';
-import useBaseUrl from '@docusaurus/useBaseUrl';
Here's how to add Plausible Analytics to your Webflow site and set up the tracking of custom events such as button clicks and form submissions.
@@ -18,20 +17,12 @@ Here's how to add Plausible Analytics to your Webflow site and set up the tracki
## How to add Plausible to your Webflow website
-* On your project's page, click on the Webflow logo (**W**) in the left-hand side menu and choose **Project Settings**.
+* Open your site's **Site settings** from the Webflow Dashboard, then select **Custom code**.
-
-
})
-
-
-* You can use the **[Custom Code](https://university.webflow.com/lesson/custom-code-in-the-head-and-body-tags)** feature in Webflow to add Plausible tracking code to your website. Site-wide JavaScript code injection is a premium Webflow feature so you need to upgrade your Webflow account to a paid subscription plan.
+* You can use the **[Custom Code](https://help.webflow.com/hc/en-us/articles/33961357265299-Custom-code-in-head-and-body-tags)** feature in Webflow to add Plausible tracking code to your website. Your site or Workspace needs a plan that supports custom code; see Webflow's requirements in the linked guide.
* Choose **Custom Code** from the menu and [paste your Plausible snippet](https://plausible.io/docs/plausible-script) in the **Head Code** section. 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).
-
-
})
-
-
* Do click on the **Save Changes** button and then **Publish** your changes.
Now you can go to your Webflow website and verify that Plausible script has been added and to your Plausible account to see whether the stats are being tracked. See here [how to verify the integration](troubleshoot-integration.md).
@@ -44,17 +35,9 @@ The easiest way to track form submissions on your Webflow site is to track the "
First you'll need to create a "thank you" page by clicking on the "Pages" panel and creating the page by clicking on the "Create New Page" button.
-
-
})
-
-
### 2. Set the redirect URL on form submission
-Go to the page that contains your form, select the form and click on the gear icon to access the form settings. In the "Redirect URL" field type in the path to the thank you page ( i.e. **/thank-you** )
-
-
-
})
-
+Select your form and open its **Settings** panel. Set the post-submit redirect to your thank-you page, either by selecting the page or entering its path, such as `/thank-you`. Save and publish your changes. See [Webflow's form settings guide](https://help.webflow.com/hc/en-us/articles/33961347548563-How-do-I-add-forms-in-Webflow) for the current controls.
### 3. Create a pageview goal in your Plausible account
@@ -72,14 +55,12 @@ Your goal should now be set up. When you navigate back to your Plausible Analyti
### 1. Set an ID to the element you want to track
-In Webflow, link and button elements don't have a default ID. You'll need to assign an ID by selecting the element and clicking on the settings gear. In the **Designer View**, you'll be able to set the ID.
-
-
-
})
-
+Select the link or button in Webflow and open its **Element settings**. Set its **ID** to a unique value, such as `button-click`. Use that same value in the code below.
### 2. Trigger custom events with JavaScript on your site
+Keep your [current Plausible tracking snippet](plausible-script.md) installed. Add the code below alongside it; it does not replace your tracking snippet.
+
Here's the code you will need to insert in the `` section of the page where the element ID that you want to track is located. You can use the **Custom Code** feature to do this similarly to how you've inserted the Plausible snippet into your site.
Make sure to change the `elementId` line in the code below to include the ID attribute of the element you want to track (`button-click` in our example).
@@ -108,10 +89,6 @@ To represent a space in a goal name, use a `+` sign. For example: `plausible-eve
```
-
-
})
-
-
Do click on the **Save Changes** button and then **Publish** your changes.
### 3. Create a custom event goal in your Plausible account
@@ -158,10 +135,6 @@ If you want to trigger multiple custom events on the same site, you don't need t
```
-
-
})
-
-
## Custom event not showing up?
### Did you publish your changes?
diff --git a/docs/wordpress-integration.md b/docs/wordpress-integration.md
index 02a9f730..da681c1d 100644
--- a/docs/wordpress-integration.md
+++ b/docs/wordpress-integration.md
@@ -29,10 +29,6 @@ Then install the plugin from your WordPress dashboard:
2. Click **Add Plugin** and search for "Plausible Analytics".
3. Open the official listing, then **Install** and **Activate**.
-
-
})
-
-
You can also install it from the [official plugin directory](https://wordpress.org/plugins/plausible-analytics/). After activation, the plugin walks you through a Get Started guide. Every option there is also available later in the plugin settings screen, described below.