diff --git a/docs/2fa.md b/docs/2fa.md index adb3bb25..f9a5d8cf 100644 --- a/docs/2fa.md +++ b/docs/2fa.md @@ -10,8 +10,8 @@ To enable the 2FA on your Plausible account, you are required to insert the secu ## How to enable 2FA -* Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose "**Account Settings**" to enter your account settings. -* In the "**Security**" section, find “**Two-Factor Authentication (2FA)**” and click on the “**Enable 2FA**” button. +* Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose **Account Settings** to enter your account settings. +* In the **Security** section, find “**Two-Factor Authentication (2FA)**” and click on the “**Enable 2FA**” button. Enable 2FA * Link your Plausible account to your authenticator app by scanning the QR code or pasting the code manually. Then click on the “**Proceed**” button. * Enter the verification code from your authenticator application and click on the “**Verify**” button. @@ -24,18 +24,18 @@ To enable the 2FA on your Plausible account, you are required to insert the secu To improve your account security, you can require all your team members to enable two-factor authentication (2FA): * First, set up a team if you haven’t already. Here’s [how to create one](users-roles.md). -* In the top-right menu, click your account name, select the team you want to manage, then open "**Team Settings**". -* In the "**General**" section of "**Team Settings**", you’ll find the "**Force Two-Factor Authentication (2FA)**" option. -* Click "**Enforce 2FA**" to make it mandatory for all team members. +* In the top-right menu, click your account name, select the team you want to manage, then open **Team Settings**. +* In the **General** section of **Team Settings**, you’ll find the **Force Two-Factor Authentication (2FA)** option. +* Click **Enforce 2FA** to make it mandatory for all team members. Enforce 2FA * Confirm by clicking OK. All members, including you, will need to set up 2FA before they can access the team sites. -* To remove the requirement later, click "**Stop Forcing 2FA**". +* To remove the requirement later, click **Stop Forcing 2FA**. ## How to generate new recovery codes Have you lost your recovery codes? You can generate new codes at any time. You can use a recovery code to log in to your Plausible account if you lose access to your authenticator app or your trusted device. -* In your Plausible account settings "**Security**" section, find “**Two-Factor Authentication (2FA)**” and click the “**Generate new**” link. +* In your Plausible account settings **Security** section, find “**Two-Factor Authentication (2FA)**” and click the “**Generate new**” link. Generate new 2FA recovery codes * Confirm your account password and click the “**Generate New Codes**” button. Generate new 2FA recovery codes @@ -45,7 +45,7 @@ Note that when you generate new recovery codes, your old recovery codes will bec ## How to disable 2FA -* In your Plausible account settings "**Security**" section, find “**Two-Factor Authentication (2FA)**” and click on the “**Disable 2FA**” button. +* In your Plausible account settings **Security** section, find “**Two-Factor Authentication (2FA)**” and click on the “**Disable 2FA**” button. Disable 2FA * Then enter your account password and click the “**Disable 2FA**” button to complete the process. diff --git a/docs/add-website.md b/docs/add-website.md index 3dc76a76..656a80e2 100644 --- a/docs/add-website.md +++ b/docs/add-website.md @@ -4,11 +4,11 @@ title: Add your website details import useBaseUrl from '@docusaurus/useBaseUrl'; -Once you have an account, you can enter the domain name of the website you want to track. For example, if your site is `https://www.yourdomain.com`, enter `yourdomain.com` in the "**Domain**" field. Remove `https://` and `www.` from the URL. +Once you have an account, you can enter the domain name of the website you want to track. For example, if your site is `https://www.yourdomain.com`, enter `yourdomain.com` in the **Domain** field. Remove `https://` and `www.` from the URL. Does your site operate on multiple subdomains such as `docs.yourdomain.com` and `app.yourdomain.com`? Simply add your main domain name (`yourdomain.com`) to your Plausible account and use the same tracking snippet on all your subdomains. This keeps the visitor session [active between the main site and its subdomains](subdomain-hostname-filter.md). -If you'd like to track a particular subdomain independently from the rest of your site, you can do that too. For example, if the subdomain you want to track on its own is `https://blog.yourdomain.com` then the part to enter in the "**Domain**" field is `blog.yourdomain.com`. +If you'd like to track a particular subdomain independently from the rest of your site, you can do that too. For example, if the subdomain you want to track on its own is `https://blog.yourdomain.com` then the part to enter in the **Domain** field is `blog.yourdomain.com`.
Add your website details to Plausible Analytics @@ -22,8 +22,8 @@ In some setups, you may want to track traffic under a different domain than wher You need to select your reporting timezone too. 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. +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. -Click on the "**Add snippet**" button to go to the next step where we will provide you with the tracking snippet that you need to [insert into your site](plausible-script.md) to start counting your stats. +Click on the **Add snippet** button to go to the next step where we will provide you with the tracking snippet that you need to [insert into your site](plausible-script.md) to start counting your stats. diff --git a/docs/billing.md b/docs/billing.md index 8a96adcc..accfd41d 100644 --- a/docs/billing.md +++ b/docs/billing.md @@ -6,7 +6,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; ## Is the billing based per account or per website? -Billing is based on total usage across all the sites in a team. Each team has its own subscription and is billed separately. Check your usage numbers at any time in the "**Subscription**" section of your account settings. For details on how usage is calculated, see [Choose the right subscription](subscription-plans.md). +Billing is based on total usage across all the sites in a team. Each team has its own subscription and is billed separately. Check your usage numbers at any time in the **Subscription** section of your account settings. For details on how usage is calculated, see [Choose the right subscription](subscription-plans.md). ## Can I manage multiple clients with separate billing for each? @@ -28,11 +28,11 @@ If paying via PayPal, make sure a valid card is linked to your PayPal account. P ## How do I add my VAT number? -If you're purchasing on behalf of a business, click "**Add VAT number**" on the second step of the checkout, where you also add your payment details. Paddle handles all sales tax calculations and will apply the correct rate based on your details. +If you're purchasing on behalf of a business, click **Add VAT number** on the second step of the checkout, where you also add your payment details. Paddle handles all sales tax calculations and will apply the correct rate based on your details. Add VAT number at checkout -If you missed this step, open any Paddle invoice and click "**Add address & VAT Number**". Paddle will automatically refund the VAT on your original payment and apply the correct rate to future payments. [More on Paddle's VAT handling →](https://paddle.com/support/which-countries-does-paddle-charge-vat-for/) +If you missed this step, open any Paddle invoice and click **Add address & VAT Number**. Paddle will automatically refund the VAT on your original payment and apply the correct rate to future payments. [More on Paddle's VAT handling →](https://paddle.com/support/which-countries-does-paddle-charge-vat-for/) ## How do I change my VAT number? @@ -40,7 +40,7 @@ Paddle does not allow editing the VAT number on an existing subscription. To upd ## How do I change my billing address? -Open any invoice and click "**Edit business address**" to update your street address, city or postal code. +Open any invoice and click **Edit business address** to update your street address, city or postal code. ## How do I change the country on my subscription? @@ -66,7 +66,7 @@ If you downgrade to a lower tier, the unused portion of your current billing per ## How do I update my payment method? -In your account settings, go to the "**Subscription**" section. Under "**Next bill amount**", click "**Update billing info**". +In your account settings, go to the **Subscription** section. Under **Next bill amount**, click **Update billing info**.
Update Plausible billing information diff --git a/docs/buttondown.md b/docs/buttondown.md index 178ca2b2..69f70a20 100644 --- a/docs/buttondown.md +++ b/docs/buttondown.md @@ -10,33 +10,33 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; Newsletter signups won’t show up automatically in your Plausible dashboard. You’ll have to configure the goal for them to show up. -To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the "**Goals**" section. You should see a prompt to add a goal. +To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the **Goals** section. You should see a prompt to add a goal. Add your first goal -Click on the "**+ Add goal**" button to go to the goal creation form. +Click on the **+ Add goal** button to go to the goal creation form. Select `Custom event` as the goal trigger and enter this exact name: `Subscribe`. Add Subscribe goal -Next, click on the "**Add goal**" button, and you’ll be taken back to the Goals page. After you've completed this process, all the newsletter signups will start being tracked and will be displayed in the "**Goals**" report of your Plausible Analytics dashboard. +Next, click on the **Add goal** button, and you’ll be taken back to the Goals page. After you've completed this process, all the newsletter signups will start being tracked and will be displayed in the **Goals** tab of your Plausible Analytics dashboard. -You'll see "**Subscribe**" goal as soon as the first subscriber has been tracked. That's all you need to do. Plausible will automatically record new goals (including which page your subscriber is on) whenever you get a new subscriber. +You'll see **Subscribe** goal as soon as the first subscriber has been tracked. That's all you need to do. Plausible will automatically record new goals (including which page your subscriber is on) whenever you get a new subscriber. ## How to track outbound link clicks Outbound link clicks won’t show up automatically in your Plausible dashboard. You’ll have to configure the goal for them to show up. -To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the "**Goals**" section like you just did above. Click on the "**+ Add goal**" button to go to the goal creation form. +To configure a goal, go to your website’s settings in your Plausible Analytics account and visit the **Goals** section like you just did above. Click on the **+ Add goal** button to go to the goal creation form. Select `Custom event` as the goal trigger and enter this exact name: `Outbound Link: Click`. Add Outbound Link Click goal -Next, click on the "**Add goal**" button to be taken back to the Goals page. After you've completed this process, all the external link clicks will start being tracked and will be displayed in the "**Goals**" report of your Plausible Analytics dashboard. +Next, click on the **Add goal** button to be taken back to the Goals page. After you've completed this process, all the external link clicks will start being tracked and will be displayed in the **Goals** tab of your Plausible Analytics dashboard. -You'll see "**Outbound Link: Click**" goal as soon as the first external link click has been tracked. That's all you need to do. Plausible will automatically record new external link clicks. +You'll see **Outbound Link: Click** goal as soon as the first external link click has been tracked. That's all you need to do. Plausible will automatically record new external link clicks. ## Verify that the stats are being tracked diff --git a/docs/cancel-subscription.md b/docs/cancel-subscription.md index fd8c237a..badc12c6 100644 --- a/docs/cancel-subscription.md +++ b/docs/cancel-subscription.md @@ -4,9 +4,9 @@ title: Cancel your subscription plan import useBaseUrl from '@docusaurus/useBaseUrl'; -Log in to your Plausible account. In the top right menu, click your account name → "**Account Settings**". +Log in to your Plausible account. In the top right menu, click your account name → **Account Settings**. -Go to the "**Subscription**" section and click "**Cancel plan**". +Go to the **Subscription** section and click **Cancel plan**.
Cancel your Plausible subscription @@ -32,6 +32,6 @@ You can delete your data at any time, before or after canceling, either for indi **Resubscribing** -If you resubscribe at any time within the retention period, your dashboards unlock automatically, data collection resumes and all your historical data will still be there. You can resubscribe from the "**Subscription**" section in your account settings. +If you resubscribe at any time within the retention period, your dashboards unlock automatically, data collection resumes and all your historical data will still be there. You can resubscribe from the **Subscription** section in your account settings. Want to switch plans instead of canceling? See [Change your subscription plan](change-plan.md). diff --git a/docs/carrd-integration.md b/docs/carrd-integration.md index df74d714..95efd8f6 100644 --- a/docs/carrd-integration.md +++ b/docs/carrd-integration.md @@ -10,24 +10,24 @@ Here's how to add Plausible Analytics to your Carrd site and set up the tracking ### Get your site snippet -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). +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). ### Go to your Carrd website editor -* Go to the editor of your Carrd website and add an "**Embed**" component. +* Go to the editor of your Carrd website and add an **Embed** component. Add embed element to Carrd * In the element's settings make sure: -- Type is set to "**Code**" -- Style is set to "**Hidden**" and "**Head**" +- Type is set to **Code** +- Style is set to **Hidden** and **Head** * 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. -* 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**" report of your Plausible Analytics dashboard. +* 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. Add Plausible Analytics script to Carrd @@ -39,13 +39,13 @@ Now you can go to your Carrd website and verify that Plausible script has been a As an alternative to custom events, check out [pageview goals](pageview-goals.md). Since pageviews are collected automatically, you don’t need to change your website’s code to measure pageview goals. This makes pageview goals the easiest way to start tracking any type of conversions. ::: -You can enable form submission 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). +You can enable form submission 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). ## Tracking button clicks and other links on your Carrd site ### 1. Set an ID to the element you want to track -In Carrd buttons and links have default IDs. Usually they're assigned IDs based on the order you've added them. So first button or link has an ID of "**buttons01**"/"**links01**", second button or link has an ID of "**buttons02**"/"**links02**" and so on and so forth. +In Carrd buttons and links have default IDs. Usually they're assigned IDs based on the order you've added them. So first button or link has an ID of **buttons01**/**links01**, second button or link has an ID of **buttons02**/**links02** and so on and so forth. If you're on a higher plan, like Pro Plus, you'll be able to set these IDs yourself from the element's settings. @@ -55,7 +55,7 @@ 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 -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. +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). @@ -83,21 +83,21 @@ Also do change the `classes` line to include the goal name in this format: `plau Modify Plausible script Carrd -Do click on the "**Save Changes**" button and then "**Publish**" your changes. +Do click on the **Save Changes** button and then **Publish** your changes. ### 3. Create a custom event goal in your Plausible account When you send custom events to Plausible, they won't show up in your dashboard automatically. You'll have to configure the goal for the conversion numbers to show up. -To configure a goal, go to [your website's settings](website-settings.md) in your Plausible account and visit the "**Goals**" section. +To configure a goal, go to [your website's settings](website-settings.md) in your Plausible account and visit the **Goals** section. -Click on the "**+ Add goal**" button to go to the goal creation form. Select `Custom event` as the goal trigger and enter the name of the custom event you are triggering. The name must be an exact match to the one you added to your site for the conversions to show up in your dashboard. +Click on the **+ Add goal** button to go to the goal creation form. Select `Custom event` as the goal trigger and enter the name of the custom event you are triggering. The name must be an exact match to the one you added to your site for the conversions to show up in your dashboard. So in our example where we added a goal name `plausible-event-name=Button+Click` to the Carrd site, the goal to add in the Plausible account is `Button Click` (plus is replaced by a space). Add your custom event goal -Next, click on the "**Add goal**" button and you'll be taken back to the Goals page. +Next, click on the **Add goal** button and you'll be taken back to the Goals page. ### 4. Your goal should now be ready and tracking diff --git a/docs/change-domain-name.md b/docs/change-domain-name.md index 335468c8..227a4de8 100644 --- a/docs/change-domain-name.md +++ b/docs/change-domain-name.md @@ -14,17 +14,17 @@ Use the [site ownership transfer](transfer-ownership.md) functionality instead 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 +- 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 +- Click on the **Change domain** button in the **Site domain** section
Change domain name in Plausible
-- 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. +- 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. -- Click on the "**Change domain**" button to proceed with the domain name change +- Click on the **Change domain** button to proceed with the domain name change - After a successful domain change, we will attempt to visit your new domain in order to advise you on the next steps (which depend on how you've set up Plausible). You should see a loading spinner while the process is ongoing, and a tailored recommendation once it finishes. Note that the same information is available in step 1 of the checklist below. We recommend you to go over that checklist to make sure your entire Plausible integration will continue working as before. diff --git a/docs/change-email.md b/docs/change-email.md index 7794e777..52b8086c 100644 --- a/docs/change-email.md +++ b/docs/change-email.md @@ -4,11 +4,11 @@ title: Change your account email address import useBaseUrl from '@docusaurus/useBaseUrl'; -Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose "**Account Settings**" to enter your account settings. +Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose **Account Settings** to enter your account settings. Access your account's settings -To change your account email address, go into the "**Security**" section. Find the "**Email Address**" area, provide your current password and new email, and click on the "**Change Email**" button. You will be then requested to provide a verification code which will be sent to your new email address. +To change your account email address, go into the **Security** section. Find the **Email Address** area, provide your current password and new email, and click on the **Change Email** button. You will be then requested to provide a verification code which will be sent to your new email address. Note that our system has two email addresses and that these may not necessarily be the same. One is for your Plausible account and the other one for your Paddle account. Paddle is our payment processor and they send the billing emails such as invoices to the email address on your Paddle account. diff --git a/docs/change-plan.md b/docs/change-plan.md index 94f1b0b8..b95716b9 100644 --- a/docs/change-plan.md +++ b/docs/change-plan.md @@ -4,15 +4,15 @@ title: Change your subscription plan import useBaseUrl from '@docusaurus/useBaseUrl'; -Log in to your Plausible account. In the top right menu, click your account name → "**Account Settings**". +Log in to your Plausible account. In the top right menu, click your account name → **Account Settings**. -Go to the "**Subscription**" section and click the "**Change plan**" button. +Go to the **Subscription** section and click the **Change plan** button.
Change Plausible Plan
-Select your new plan, tier and billing frequency (monthly or yearly), then click "**Preview changes**". +Select your new plan, tier and billing frequency (monthly or yearly), then click **Preview changes**.
Preview plan changes @@ -23,7 +23,7 @@ You'll see a summary of the change: - **Immediate charge** - a pro-rated amount reflecting what you've already paid and the time remaining on your current cycle. A negative amount means you have a credit balance that will automatically reduce your upcoming payments until it's used up. - **Next renewal** - the date and amount of your next regular payment. -Click "**Confirm plan change**" to apply. +Click **Confirm plan change** to apply.
Confirm plan change @@ -32,7 +32,7 @@ Click "**Confirm plan change**" to apply. Your subscription renews automatically and you can change or [cancel](cancel-subscription.md) at any time. :::tip -Not sure which tier fits? Check your current usage in the "**Subscription**" section. You can also see [Choose the right subscription](subscription-plans.md) for guidance on how usage is calculated. +Not sure which tier fits? Check your current usage in the **Subscription** section. You can also see [Choose the right subscription](subscription-plans.md) for guidance on how usage is calculated. Dealing with a traffic spike? You can upgrade now to restore access and downgrade again once traffic drops. See [Traffic spikes and overages](subscription-plans.md#traffic-spikes-and-overages) for how it works. ::: diff --git a/docs/compare-stats.md b/docs/compare-stats.md index 6030be24..144d1f26 100644 --- a/docs/compare-stats.md +++ b/docs/compare-stats.md @@ -20,7 +20,7 @@ You can also change the chart interval, [segment your audience](filters-segments - Select your primary date range using the date picker in the top right of your dashboard or by using one of our [keyboard shortcuts](keyboard-shortcuts.md). -- Then select “**Compare**” in the date picker or press the “**X**” key [on your keyboard](keyboard-shortcuts.md) to enable the comparison feature. +- Then select **Compare** in the date picker or press `X` [on your keyboard](keyboard-shortcuts.md) to enable the comparison feature. - Choose your comparison option from the drop-down. @@ -42,7 +42,7 @@ As with everything else on the dashboard, we'll save your comparison preference Comparison chart
-- Want to disable the comparison and get back to the regular view? Press the “**X**” key on your keyboard or choose “**Disable comparison**” in the comparison drop-down +- Want to disable the comparison and get back to the regular view? Press `X` on your keyboard or choose **Disable comparison** in the comparison drop-down
Disable comparison @@ -54,15 +54,15 @@ First, filter the dashboard in any way you want to [segment your audience](filte ### Choose a chart interval -In the options menu (the **⋮** icon in the top right of the chart), you can choose the unit of time the stats on the chart are grouped by under "**Graph interval**". This gives you a more granular comparison view. The available interval options depend on the date range you've selected. For example, if you select "Last 28 days" as your primary date range, you can display the stats by day or by week. +In the options menu (the **⋮** icon in the top right of the chart), you can choose the unit of time the stats on the chart are grouped by under **Graph interval**. This gives you a more granular comparison view. The available interval options depend on the date range you've selected. For example, if you select "Last 28 days" as your primary date range, you can display the stats by day or by week. ## Match day of the week or match exact date The comparison can be aligned by day of the week or by exact calendar date. Matching by day of the week means your primary date range is compared to the secondary date range starting with the same day of the week. This helps you eliminate discrepancies due to weekend or weekday differences. -The alternative option in the comparison drop-down is to "**Match exact date**". When choosing Sunday January 1st to January 7th 2023 as the primary date range and matching by exact date, the year over year comparison will be against Saturday January 1st to January 7th 2022. +The alternative option in the comparison drop-down is to **Match exact date**. When choosing Sunday January 1st to January 7th 2023 as the primary date range and matching by exact date, the year over year comparison will be against Saturday January 1st to January 7th 2022. -But when "**Match day of the week**" is selected, the comparison will be against Sunday January 2nd to January 8th 2022 instead. It's still compared to the same amount of time but the secondary date range is aligned by day of the week to get more accurate data. +But when **Match day of the week** is selected, the comparison will be against Sunday January 2nd to January 8th 2022 instead. It's still compared to the same amount of time but the secondary date range is aligned by day of the week to get more accurate data.
Match exact date @@ -74,11 +74,11 @@ Here are the details on the available comparison options: ### Previous period -Your primary date range will be compared to the same amount of time in the period before it. If you select "**Last 7 days**" as your primary date range, the stats are compared to the previous seven days before it. +Your primary date range will be compared to the same amount of time in the period before it. If you select **Last 7 days** as your primary date range, the stats are compared to the previous seven days before it. ### Year over year -Your primary date range will be compared to the same period of the previous calendar year. If you select January 1st to January 7th 2023 as your primary date range and choose "**Match exact date**", a comparison to January 1st to January 7th 2022 will be shown. +Your primary date range will be compared to the same period of the previous calendar year. If you select January 1st to January 7th 2023 as your primary date range and choose **Match exact date**, a comparison to January 1st to January 7th 2022 will be shown. ### Custom period diff --git a/docs/consolidated-views.md b/docs/consolidated-views.md index 18e69885..bb44fd51 100644 --- a/docs/consolidated-views.md +++ b/docs/consolidated-views.md @@ -4,7 +4,7 @@ title: Consolidated View import useBaseUrl from '@docusaurus/useBaseUrl'; -If you have multiple websites in your Plausible account, the "**Consolidated View**" gives you an overview of traffic across all of them. This allows you to quickly see the total number of visitors and other key metrics across all your properties in one place. +If you have multiple websites in your Plausible account, the **Consolidated View** gives you an overview of traffic across all of them. This allows you to quickly see the total number of visitors and other key metrics across all your properties in one place. It looks just like any other Plausible dashboard, but the data includes all your sites instead of just one. This way you can get detailed insights into individual site performance and a holistic view of your whole network too. @@ -25,13 +25,13 @@ It looks just like any other Plausible dashboard, but the data includes all your ## A holistic view of your whole network -Your consolidated view will appear automatically on [the /sites page](landing-page.md) if you have a [team](/users-roles#creating-a-new-team) with at least two sites. +Your consolidated view will appear automatically on [the Sites page](landing-page.md) if you have a [team](/users-roles#creating-a-new-team) with at least two sites. The consolidated view requires no setup, configuration or ongoing maintenance. Your consolidated dashboard automatically includes the stats from all of the sites in your team. When you add a new site to your team, it will automatically be included in the consolidated view. When you remove a site from your team, all the data from that site including historical stats will automatically be removed from the consolidated view too. -Just like a regular site, a consolidated view has its own settings. You can access the settings directly from the /sites page, or the site picker menu on the top left of the consolidated dashboard. +Just like a regular site, a consolidated view has its own settings. You can access the settings directly from the Sites page, or the site picker menu on the top left of the consolidated dashboard.
Consolidated traffic view diff --git a/docs/countries.md b/docs/countries.md index 3f674056..ed8389bf 100644 --- a/docs/countries.md +++ b/docs/countries.md @@ -4,27 +4,27 @@ title: Top countries, regions and cities import useBaseUrl from '@docusaurus/useBaseUrl'; -Your "**Locations**" report shows where in the world your visitors are coming from. You can click the "**Details**" button to see the full list ranked by the number of visitors. There you can also see the percentage of your total traffic the individual location stands for. Click on any such metric heading to sort and arrange your data in ascending or descending order. +The **Countries**, **Regions** and **Cities** tabs show where in the world your visitors are coming from. You can click the expand icon in the top right to see the full list ranked by the number of visitors. There you can also see the percentage of your total traffic the individual location stands for. Click on any such metric heading to sort and arrange your data in ascending or descending order. -Click on any country to see the list of regions within that country where your visitors are coming from. Click on any region to see the list of cities within that region. You can also use the "**Countries**", "**Regions**" and "**Cities**" tabs on the top of the report. +Click on any country to see the list of regions within that country where your visitors are coming from. Click on any region to see the list of cities within that region. You can also switch directly between the **Countries**, **Regions** and **Cities** tabs. ## Visitors using VPNs and similar services -To improve the location accuracy, visitors using VPN services or the Tor browser are grouped under the "**Anonymous VPN Service**" entry in the "**Countries**" tab. This method reduces the noise caused by analytics tools recording VPN server locations instead of actual user locations, while also making it easier to view the percentage of visitors using VPNs. +To improve the location accuracy, visitors using VPN services or the Tor browser are grouped under the "Anonymous VPN Service" entry in the **Countries** tab. This method reduces the noise caused by analytics tools recording VPN server locations instead of actual user locations, while also making it easier to view the percentage of visitors using VPNs. -You can use the "**Filter**" button on the top of your dashboard to segment the traffic by multiple countries, regions or cities at the same time. This allows you to group specific geographical regions and display only that traffic. +You can use the **Filter** button on the top of your dashboard to segment the traffic by multiple countries, regions or cities at the same time. This allows you to group specific geographical regions and display only that traffic. Countries - multiple filters ## How to block traffic from specific countries -You can use [the "**Filter**" button](filters-segments.md) to temporarily filter out traffic from particular countries, regions or cities when doing your reporting and analysis. +You can use [the **Filter** button](filters-segments.md) to temporarily filter out traffic from particular countries, regions or cities when doing your reporting and analysis. If you prefer to permanently block traffic from specific countries from being recorded in your dashboard, you can do so in your site settings: * Visit the [site settings area](website-settings.md) for the dashboard in question -* Choose "**Countries**" in the "**Shields**" entry in the left-hand menu -* Then click on the "**Add Country**" button to add a new country to your block list +* Choose **Countries** in the **Shields** entry in the left-hand menu +* Then click on the **Add Country** button to add a new country to your block list Block countries diff --git a/docs/csv-import.md b/docs/csv-import.md index 9d2d1bcc..7137db87 100644 --- a/docs/csv-import.md +++ b/docs/csv-import.md @@ -18,11 +18,11 @@ 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 the **CSV** button to import your CSV files. Import CSV -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. +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. Select CSV and import @@ -38,19 +38,19 @@ No data export/import is needed in this case either. We have an easy way to [cha 1. First you need to export your stats. Go to the Plausible [site settings](website-settings.md) for the website you'd like to export the data for. -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. +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 the **CSV** button 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. +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. -5. Imported data will be displayed alongside your native Plausible data in the same Plausible dashboard. You can turn this off by opening the options menu (the **⋮** icon in the top right of the chart) and toggling off "**Include imported data**". +5. Imported data will be displayed alongside your native Plausible data in the same Plausible dashboard. You can turn this off by opening the options menu (the **⋮** icon in the top right of the chart) and toggling off **Include imported data**. ## Multiple imports into the same Plausible dashboard If you'd like to make several imports into the same Plausible dashboard, please go through the process above again and choose different CSV files to import. You can import a maximum of 5 different properties into one Plausible dashboard. You can import using both of our import methods (CSV files and Google Analytics import) into the same Plausible dashboard. -In the "**Imports & Exports**" section, you can see the overview of all your existing imports to that specific Plausible dashboard. For each import, we list the ID, the number of pageviews imported and the time range that the import covers. +In the **Imports & Exports** section, you can see the overview of all your existing imports to that specific Plausible dashboard. For each import, we list the ID, the number of pageviews imported and the time range that the import covers. ## How much data is imported? @@ -58,7 +58,7 @@ Data is imported in aggregate for each date, from your first import visitor unti ## How can I delete imported data? -Data you have imported can be deleted by returning to your site's "**Imports & Exports**" settings page and clicking the "**Delete Import**" button in the "**Existing Imports**" section. This action won't affect the native data you have collected using our script directly. +Data you have imported can be deleted by returning to your site's **Imports & Exports** settings page and clicking the **Delete Import** button in the **Existing Imports** section. This action won't affect the native data you have collected using our script directly. ## How does imported data differ from native data? @@ -78,7 +78,7 @@ There are several exceptions to this though, because some properties are aggrega * `Outbound Link: Click` and `File Download` goals with the `url` property * `404` goals with the `path` property -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**". +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**. Stats include imported data diff --git a/docs/custom-automatic-link-tracking.md b/docs/custom-automatic-link-tracking.md index 7354d593..0cb95443 100644 --- a/docs/custom-automatic-link-tracking.md +++ b/docs/custom-automatic-link-tracking.md @@ -75,14 +75,14 @@ where `\/` stands for a forward slash (escaped with `\`) and `.*` will match any ## 2. Create a custom event goal in your Plausible Analytics account -You'll have to configure the goal for the click numbers to show up in your Plausible dashboard. To configure a goal, go to [your website's settings](website-settings.md) in your Plausible Analytics account and visit the "**Goals**" section. You should see an empty list with a prompt to add a goal. +You'll have to configure the goal for the click numbers to show up in your Plausible dashboard. To configure a goal, go to [your website's settings](website-settings.md) in your Plausible Analytics account and visit the **Goals** section. You should see an empty list with a prompt to add a goal. Add your first goal -Click on the "**+ Add goal**" button to go to the goal creation form. +Click on the **+ Add goal** button to go to the goal creation form. Select `Custom event` as the goal trigger and enter this exact name: `Cloaked Link: Click`. -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 have completed your new custom event. Goals are listed at the bottom of your dashboard. Note that at least one click is required for this to show in your dashboard. +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 have completed your new custom event. Goals are listed at the bottom of your dashboard. Note that at least one click is required for this to show in your dashboard. That's it. You're now tracking all link clicks on your site with custom URL matching rules! diff --git a/docs/custom-event-goals.md b/docs/custom-event-goals.md index 948189b2..ddfcbc5f 100644 --- a/docs/custom-event-goals.md +++ b/docs/custom-event-goals.md @@ -159,11 +159,11 @@ var toTag = [ When you send custom events to Plausible, they won't show up in your dashboard automatically. You'll have to configure the goal for the conversion numbers to show up. -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. +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. Add your first goal -Click on the "**+ Add goal**" button to go to the goal creation form. +Click on the **+ Add goal** button to go to the goal creation form. Select `Custom event` as the goal trigger and enter the name of the custom event you are triggering. The name must match the one you added as a CSS class name on your site for conversions to appear in your analytics dashboard. So in our example where you added a CSS class name `plausible-event-name=Button+Click`, the goal to add to your Plausible account is `Button Click` (plus is replaced by a space). @@ -173,9 +173,9 @@ When creating a custom event goal, you can optionally narrow it down using custo Add your custom event goal -Next, click on the "**Add goal**" button and you'll be taken back to the Goals page. When you navigate back to your Plausible dashboard, you should see the number of visitors who triggered the custom event. Custom events are listed at the bottom of your dashboard and will appear as soon as the first conversion has been tracked. +Next, click on the **Add goal** button and you'll be taken back to the Goals page. When you navigate back to your Plausible dashboard, you should see the number of visitors who triggered the custom event. Custom events are listed at the bottom of your dashboard and will appear as soon as the first conversion has been tracked. -If you happen to be sending events to Plausible already, you might see the following message under the "**Add goal**" button: +If you happen to be sending events to Plausible already, you might see the following message under the **Add goal** button: Add all custom event goals in a single action diff --git a/docs/custom-props/introduction.md b/docs/custom-props/introduction.md index 7776c8ce..81db8435 100644 --- a/docs/custom-props/introduction.md +++ b/docs/custom-props/introduction.md @@ -35,7 +35,7 @@ Note that you must ensure that no personally identifiable information (PII) is s Plausible will display `(none)` in your dashboard when you send a custom property key with no value, or `null`/`undefined` as a value. Also, when you send one event with a property (e.g. `author`) and another event with the same name, but without the `author` property, then you will also see the `(none)` value because the property has not been sent with every event. -When you filter your dashboard by a particular custom event and look at the "**Properties**" tab, you should only see `(none)` if some of those events were sent without the property. However, if you're viewing the "**Properties**" tab without any custom event filter, it returns all the events in your dashboard (including all regular pageviews) and many of these events may not have a property attached. This is why you see the `(none)` value. +When you filter your dashboard by a particular custom event and look at the **Properties** tab, you should only see `(none)` if some of those events were sent without the property. However, if you're viewing the **Properties** tab without any custom event filter, it returns all the events in your dashboard (including all regular pageviews) and many of these events may not have a property attached. This is why you see the `(none)` value. ## Accepted values diff --git a/docs/custom-props/props-dashboard.md b/docs/custom-props/props-dashboard.md index bc11998d..23c0f3ee 100644 --- a/docs/custom-props/props-dashboard.md +++ b/docs/custom-props/props-dashboard.md @@ -8,26 +8,26 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; When you send custom properties to Plausible, they won't show up in your dashboard automatically. You'll have to configure the custom property for the numbers to show up. -To configure a property, go to the [site settings](website-settings.md) in your Plausible account and visit the "**Custom Properties**" section. You should see an empty list with a prompt to add a property. You also have the option to add all properties that you've already sent with one click. +To configure a property, go to the [site settings](website-settings.md) in your Plausible account and visit the **Custom Properties** section. You should see an empty list with a prompt to add a property. You also have the option to add all properties that you've already sent with one click. ## 2. Filter your stats by custom properties As soon as you've recorded at least one custom event or one pageview with a custom property attached to it, you'll be able to see an option to filter by that property in your Plausible dashboard. -At the bottom of your dashboard, in the "**Goals**" section you can switch to the "**Properties**" tab. There you can select a specific custom property to see the related data. After you filter the dashboard by one particular custom property, you can segment your stats even further by adding additional custom properties to the filter. Keep clicking on custom properties to add more segments. +At the bottom of your dashboard, in the **Goals** section you can switch to the **Properties** tab. There you can select a specific custom property to see the related data. After you filter the dashboard by one particular custom property, you can segment your stats even further by adding additional custom properties to the filter. Keep clicking on custom properties to add more segments. -Clicking on any of your custom events in the "**Goals**" section will also take you to the "**Properties**" tab to display the properties attached to that specific custom event. +Clicking on any of your custom events in the **Goals** section will also take you to the **Properties** tab to display the properties attached to that specific custom event. Custom Property Filter ### You can also use the filter menu to segment further -You can also open [the filter dropdown menu](filters-segments.md) in the top right of your dashboard and select "**Property**". +You can also open [the filter dropdown menu](filters-segments.md) in the top right of your dashboard and select **Property**. Custom Property Filter -In that view you can interact with the dropdown fields, where Plausible will automatically provide filtering suggestions based on the custom properties that we have recorded. The suggestions take into account the selected time period and other filters that you've already applied to your stats. You can choose between "**is**", "**is not**", "**does not contain**" and "**contains**" as options when selecting the custom property to filter by. +In that view you can interact with the dropdown fields, where Plausible will automatically provide filtering suggestions based on the custom properties that we have recorded. The suggestions take into account the selected time period and other filters that you've already applied to your stats. You can choose between "is", "is not", "does not contain" and "contains" as options when selecting the custom property to filter by. -You can filter by multiple custom properties too. Click on the "**Add another**" link to add another custom property to the filter. Choose the custom properties that you want to segment your audience by and click on the "**Apply Filter**" button to filter your dashboard. +You can filter by multiple custom properties too. Click on the **Add another** link to add another custom property to the filter. Choose the custom properties that you want to segment your audience by and click on the **Apply Filter** button to filter your dashboard. Custom Property Filter diff --git a/docs/custom-query-params.md b/docs/custom-query-params.md index 098ee44d..5e790795 100644 --- a/docs/custom-query-params.md +++ b/docs/custom-query-params.md @@ -2,9 +2,9 @@ title: Tracking custom query parameters --- -Query parameters `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` are valid and supported by Plausible out of the box. The parameters themselves are stripped from the page paths so they are not shown in the "**Top Pages**" report but they are used for source attribution of marketing campaigns. You can check all the clicks on links with UTM tags in the "**Campaigns**" tab of the "**Top Sources**" report. Read more about [tagging links with query parameters here](top-referrers.md). +Query parameters `ref`, `source`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` are valid and supported by Plausible out of the box. The parameters themselves are stripped from the page paths so they are not shown in the **Top Pages** tab but they are used for source attribution of marketing campaigns. You can check all the clicks on links with UTM tags in the **Campaigns** tab. Read more about [tagging links with query parameters here](top-referrers.md). -Other than the source attribution query parameters listed above, Plausible strips all other query parameters for privacy purposes. This means that pages like `yoursite.com/blog/index.php?article=some_article&page=11` will be reported as `yoursite.com/blog/index.php` in the "**Top Pages**" report of your Plausible dashboard. +Other than the source attribution query parameters listed above, Plausible strips all other query parameters for privacy purposes. This means that pages like `yoursite.com/blog/index.php?article=some_article&page=11` will be reported as `yoursite.com/blog/index.php` in the **Top Pages** tab of your Plausible dashboard. If you still want some pages to be reported with the complete URL that includes the query part, here's what you should do: diff --git a/docs/dashboard-appearance.md b/docs/dashboard-appearance.md index cb62ccc9..cc8b3671 100644 --- a/docs/dashboard-appearance.md +++ b/docs/dashboard-appearance.md @@ -6,8 +6,8 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; Plausible Analytics supports both light and dark design themes. We follow your system theme by default but logged in users can manually choose either system, dark or light theme in the account settings. -Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose "**Account Settings**" to enter your account settings. +Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose **Account Settings** to enter your account settings. -To change your Plausible Analytics theme, go to the "**Preferences**" section, find "**Dashboard Appearance**", choose your preferred theme and click on the "**Change Theme**" button. +To change your Plausible Analytics theme, go to the **Preferences** section, find **Dashboard Appearance**, choose your preferred theme and click on the **Change Theme** button. Choose between dark or light theme diff --git a/docs/dashboard-faq.md b/docs/dashboard-faq.md index 3032c766..7c9798aa 100644 --- a/docs/dashboard-faq.md +++ b/docs/dashboard-faq.md @@ -6,11 +6,11 @@ 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**' report, it adds up to 51 users. +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 51 users. Numbers not adding up -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**' report would show one unique visitor for `/page1` and one unique visitor for `/page2`. +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`. This is why adding up unique visitor numbers and comparing them to the total is misleading. Since visitors aren't limited to a single pageview or action on your site, you shouldn't expect these numbers to be equal. diff --git a/docs/delete-account.md b/docs/delete-account.md index 5d1fcf58..b5840c6a 100644 --- a/docs/delete-account.md +++ b/docs/delete-account.md @@ -4,8 +4,8 @@ title: Delete your account import useBaseUrl from '@docusaurus/useBaseUrl'; -Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose "**Account Settings**" to enter your account settings. +Log in to your Plausible Analytics account and in the top right menu, click on your account name and choose **Account Settings** to enter your account settings. -To delete your Plausible Analytics account, go to the "**Danger Zone**" section, find "**Delete Account**" and click on the big red "**Delete Account**" button. Deleting your account removes all the sites and stats you've collected. +To delete your Plausible Analytics account, go to the **Danger Zone** section, find **Delete Account** and click on the big red **Delete Account** button. Deleting your account removes all the sites and stats you've collected. Delete your Plausible Analytics account diff --git a/docs/delete-site-data.md b/docs/delete-site-data.md index 8701c416..ae0c032a 100644 --- a/docs/delete-site-data.md +++ b/docs/delete-site-data.md @@ -4,6 +4,6 @@ title: Delete your site data and your stats import useBaseUrl from '@docusaurus/useBaseUrl'; -Within the "**Danger zone**" section of [your website settings](website-settings.md) you can delete your site from Plausible Analytics. This also removes all the stats you've collected until that point. Click on the big red "**Delete**" button to delete your site and your stats from Plausible Analytics. +Within the **Danger zone** section of [your website settings](website-settings.md) you can delete your site from Plausible Analytics. This also removes all the stats you've collected until that point. Click on the big red **Delete** button to delete your site and your stats from Plausible Analytics. Delete your site data and your stats diff --git a/docs/devices.md b/docs/devices.md index d25e44b5..60831e74 100644 --- a/docs/devices.md +++ b/docs/devices.md @@ -4,25 +4,25 @@ title: Top devices, browsers and operating systems import useBaseUrl from '@docusaurus/useBaseUrl'; -Your "**Devices**" report shows the screen size, the browser and the operating system (OS) of your visitors. It helps you identify and understand the type of device your visitors use the most often so you can optimize your website experience to them. Click on any particular entry to filter the dashboard by that traffic and see further details such as the browser or OS version. +The **Browsers**, **Operating Systems** and **Devices** tabs show the screen size, browser and operating system (OS) of your visitors. They help you identify and understand the type of device your visitors use the most often so you can optimize your website experience to them. Click on any particular entry to filter the dashboard by that traffic and see further details such as the browser or OS version. -You can click the "**Details**" button to see the full list with additional details like "Visitors", "%", "Bounce Rate", and "Visit Duration". Click on any such metric heading to sort and arrange your data in ascending or descending order. +You can click the expand icon in the top right to see the full list with additional details like "Visitors", "%", "Bounce Rate", and "Visit Duration". Click on any such metric heading to sort and arrange your data in ascending or descending order. -You can use the "**Filter**" button on the top of your dashboard to segment the traffic by multiple devices at the same time. Filter button also allows you to filter out traffic from specific devices. +You can use the **Filter** button on the top of your dashboard to segment the traffic by multiple devices at the same time. Filter button also allows you to filter out traffic from specific devices. Screen sizes - multiple filters ## Screen size -Your "**Screen size**" report shows the devices used by your website visitors. Devices are categorized into desktop, mobile or tablet. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. +The **Devices** tab shows the devices used by your website visitors. Devices are categorized into desktop, mobile or tablet. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. ## Browser -Your "**Browser**" report shows what browsers people use when visiting your website. We only show the brand of the browser and when you click on the brand you can see the version number too. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. +The **Browsers** tab shows what browsers people use when visiting your website. We only show the brand of the browser and when you click on the brand you can see the version number too. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. ## Operating system -Your "**Operating system**" report shows what operating systems people use when visiting your website. We show the brand of the operating system and when you click on the brand you can see the version numbers too. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. +The **Operating Systems** tab shows what operating systems people use when visiting your website. We show the brand of the operating system and when you click on the brand you can see the version numbers too. This is derived from the User-Agent HTTP header. The full User-Agent is discarded. :::info Windows and macOS have stopped reporting their latest versions This means that Plausible and other analytics tools are not able to report the latest versions, which for Windows are above 10, and for macOS above 10.15. Visitors with the new versions will be grouped in the last known version diff --git a/docs/discourse-integration.md b/docs/discourse-integration.md index e92ff681..6be737f8 100644 --- a/docs/discourse-integration.md +++ b/docs/discourse-integration.md @@ -8,7 +8,7 @@ You can add Plausible Analytics tracking code to your Discourse community by add ## Step 1: Get your Plausible snippet -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). +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). ## Step 2: Install snippet in Discourse @@ -24,7 +24,7 @@ We display your snippet during the process of adding a new site to your account. * Note: If you're using a proxy, see [relevant instructions](/proxy/introduction.md). -* After adding your code, click on the "**Save**" button at the bottom and go back to the component screen. If it saved properly, you should see the `head` section called out as a 'custom section' under the CSS/HTML header. +* After adding your code, click on the **Save** button at the bottom and go back to the component screen. If it saved properly, you should see the `head` section called out as a 'custom section' under the CSS/HTML header. Discourse will automatically add a nonce to the script to satisfy the Content Security Policy headers so no further action is necessary for that. diff --git a/docs/docusaurus-integration.md b/docs/docusaurus-integration.md index 03e10d31..f2860af2 100644 --- a/docs/docusaurus-integration.md +++ b/docs/docusaurus-integration.md @@ -6,4 +6,4 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; There is a Plausible Analytics community plugin that allows you to integrate Plausible Analytics with your Docusaurus documentation site. -"**[A Docusaurus plugin for Plausible Analytics](https://github.com/infracost/docusaurus-plugin-plausible)**". +**[A Docusaurus plugin for Plausible Analytics](https://github.com/infracost/docusaurus-plugin-plausible)**. diff --git a/docs/download-invoices.md b/docs/download-invoices.md index 2ecdc210..99a4ced9 100644 --- a/docs/download-invoices.md +++ b/docs/download-invoices.md @@ -6,7 +6,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; Our payment processor Paddle sends an invoice by email automatically after each payment. You can also download invoices directly from your Plausible account. -Log in and go to your account name → "**Account Settings**". Scroll down in the "**Subscription**" section to see a list of all invoices. Each invoice can be downloaded directly from the list. +Log in and go to your account name → **Account Settings**. Scroll down in the **Subscription** section to see a list of all invoices. Each invoice can be downloaded directly from the list.
Download Plausible invoice @@ -14,11 +14,11 @@ Log in and go to your account name → "**Account Settings**". Scroll down in th ## Add your company address and VAT number -Open any invoice from Paddle and click "**Add address & VAT Number**". Paddle handles VAT and sales taxes. If you provide a valid VAT ID, no VAT will be charged on future payments. [More on Paddle's VAT handling →](https://paddle.com/support/which-countries-does-paddle-charge-vat-for/) +Open any invoice from Paddle and click **Add address & VAT Number**. Paddle handles VAT and sales taxes. If you provide a valid VAT ID, no VAT will be charged on future payments. [More on Paddle's VAT handling →](https://paddle.com/support/which-countries-does-paddle-charge-vat-for/) ## Change your billing address -Open any invoice and click "**Edit business address**" to update your address. +Open any invoice and click **Edit business address** to update your address. Changing the **country** on an existing subscription isn't possible due to tax regulations. To switch countries, wait for your current subscription to expire, cancel, then resubscribe from the same account with the new country. No data is lost in this process. diff --git a/docs/ecommerce-revenue-tracking.md b/docs/ecommerce-revenue-tracking.md index eeaa780a..b5f9b3cf 100644 --- a/docs/ecommerce-revenue-tracking.md +++ b/docs/ecommerce-revenue-tracking.md @@ -22,7 +22,7 @@ The revenue metrics are fully filterable. For instance, you can see the total or You can add multiple filters to [create audience segments](filters-segments.md) too. This allows you to see the conversions and revenue from for instance the audience segment that's located in Germany, Austria and Switzerland, that were referred by a particular UTM campaign and are using Mac OS. -When the revenue goal filter is applied on the dashboard, you will also find the "Revenue" column appear in all the individual reports (when expanded using the "Details" option). This is useful in seeing the breakdown of your revenue by individual traffic sources, entry or exit pages, locations, browser types and properties. You can also sort your reports by revenue in either ascending or descending order. +When the revenue goal filter is applied on the dashboard, you will also find the "Revenue" column appear in all the individual reports (when expanded using the expand icon in the top right). This is useful in seeing the breakdown of your revenue by individual traffic sources, entry or exit pages, locations, browser types and properties. You can also sort your reports by revenue in either ascending or descending order. ## Clean referral source attribution @@ -38,7 +38,7 @@ If you want to track ecommerce revenue, here's how to enable it: ### Step 1: Add a new custom event and specify the currency of your choice -Go to your [site settings](website-settings.md) and in the "**Goals**" section click on the "**Add goal**" button. Choose "**Custom event**" as the goal trigger, enter the goal name in the "**Event name**" field, switch to "**Enable Revenue Tracking**" and set the base currency of your choice. This currency will be used for total and average revenue metrics in the dashboard. Note that the currency for a specific event cannot be changed later. +Go to your [site settings](website-settings.md) and in the **Goals** section click on the **Add goal** button. Choose **Custom event** as the goal trigger, enter the goal name in the **Event name** field, switch to **Enable Revenue Tracking** and set the base currency of your choice. This currency will be used for total and average revenue metrics in the dashboard. Note that the currency for a specific event cannot be changed later. Add goal and choose your currency diff --git a/docs/email-reports.md b/docs/email-reports.md index c43129dd..21ec0c35 100644 --- a/docs/email-reports.md +++ b/docs/email-reports.md @@ -4,7 +4,7 @@ title: Set reports to be sent through email import useBaseUrl from '@docusaurus/useBaseUrl'; -Within the "**Email reports**" section of your website settings you can decide to enable weekly (every Monday) and/or monthly (every 1st day of the month) reports to be sent directly through email. +Within the **Email reports** section of your website settings you can decide to enable weekly (every Monday) and/or monthly (every 1st day of the month) reports to be sent directly through email. All the stats are embedded directly into the email and there's no need to go to the Plausible Analytics website to view them. There are no attachments, no PDFs and no links to click on in the email reports either. @@ -12,6 +12,6 @@ All the stats are embedded directly into the email and there's no need to go to ## Set email reports to be sent to multiple recipients -Email reports can be set to be sent to multiple recipients. Enable the weekly and/or monthly report, add an individual recipient into the "**Report recipients**" field and click on the "**Add recipient**" button. +Email reports can be set to be sent to multiple recipients. Enable the weekly and/or monthly report, add an individual recipient into the **Report recipients** field and click on the **Add recipient** button. You can set the email reports to be sent to as many people as you want. You can remove individual report recipients or completely stop the scheduled email reports at any time. diff --git a/docs/embed-dashboard.md b/docs/embed-dashboard.md index b046a024..f169e074 100644 --- a/docs/embed-dashboard.md +++ b/docs/embed-dashboard.md @@ -20,9 +20,9 @@ It's technically not possible to embed a password-protected dashboard. When you ## 2. Generate the embed code -In the "**Visibility**" area of your website settings there's the "**Embed dashboard**" section where you can generate the embed code. +In the **Visibility** area of your website settings there's the **Embed dashboard** section where you can generate the embed code. -Enter your shared link URL, select the theme of the embed dashboard (light, dark or system), optionally choose a custom background color and click on the "**Generate embed code**" button. +Enter your shared link URL, select the theme of the embed dashboard (light, dark or system), optionally choose a custom background color and click on the **Generate embed code** button. :::tip You can set the background color as `transparent` in the embed code It's much more convenient than figuring out the hex code for your background color diff --git a/docs/error-pages-tracking-404.md b/docs/error-pages-tracking-404.md index 0bd819a9..4fee03cf 100644 --- a/docs/error-pages-tracking-404.md +++ b/docs/error-pages-tracking-404.md @@ -10,13 +10,13 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; If you use the 404 error pages tracking feature, then these count towards your billable monthly pageviews. ::: -Tracking 404 error pages is essential for many site owners and Plausible helps you automate this process. With our "**404 error pages**" tracking you can: +Tracking 404 error pages is essential for many site owners and Plausible helps you automate this process. With our **404 error pages** tracking you can: * Get an easy overview of which 404 pages are accessed by your visitors (you can even group error pages by any keyword) * See where visitors find broken links to your 404 error pages * Then you can manually fix broken links and redirect error pages -"**404 error pages**" requires additional work in addition to [setting up tracking script](/plausible-script). If you want to track 404 error pages, here's how to enable it: +**404 error pages** requires additional work in addition to [setting up tracking script](/plausible-script). If you want to track 404 error pages, here's how to enable it: ## Step 1: Paste this piece of code to your 404 page template @@ -36,23 +36,23 @@ The quickest way to start tracking 404 error pages is to use our [official WordP 404 events won't show up in your dashboard automatically. You'll have to configure the goal for the conversion numbers to show up. -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. +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. Add your first goal -Click on the "**+ Add goal**" button to go to the goal creation form. +Click on the **+ Add goal** button to go to the goal creation form. Select `Custom event` as the goal trigger and enter `404` as the name of the custom event you are triggering. -After clicking on the "**Add goal**" button the goal will be created and you'll be taken back to the Goals page. +After clicking on the **Add goal** button the goal will be created and you'll be taken back to the Goals page. ## Step 3: See all the visits on 404 error pages in your dashboard -After updating your 404 page template and creating the goal, all the visits on 404 error pages will start being tracked and will be displayed in the "**Goals**" report of your Plausible Analytics dashboard. You'll see the "**404**" goal as soon as the first visit on a 404 error page has been tracked. +After updating your 404 page template and creating the goal, all the visits on 404 error pages will start being tracked and will be displayed in the **Goals** tab of your Plausible Analytics dashboard. You'll see the **404** goal as soon as the first visit on a 404 error page has been tracked. -Click on "**404**" to see the full list of all visits on all error pages and have your dashboard filtered by error pages only. Click on a particular error page URL to filter the dashboard by those clicks only and get the full overview of that specific URL. Then you can figure out how your visitors discover the broken links and fix them. +Click on **404** to see the full list of all visits on all error pages and have your dashboard filtered by error pages only. Click on a particular error page URL to filter the dashboard by those clicks only and get the full overview of that specific URL. Then you can figure out how your visitors discover the broken links and fix them. -You can also group 404 error pages by any keyword. In the "**Filter**" button in the top right of your dashboard, choose "**Property**". Then select "**path**" (this includes all the 404 error page paths we have recorded) and use the "**contains**" option. Add whatever keyword you want to group 404 error pages by and click on the "**Apply Filter**" button. +You can also group 404 error pages by any keyword. In the **Filter** button in the top right of your dashboard, choose **Property**. Then select **path** (this includes all the 404 error page paths we have recorded) and use the "contains" option. Add whatever keyword you want to group 404 error pages by and click on the **Apply Filter** button. Check out this blog post for more details on the value of [tracking 404 error pages](https://plausible.io/blog/track-404-errors). @@ -62,7 +62,7 @@ Plausible also offers automated tracking for [outbound link clicks](outbound-lin ## How to disable "404 error pages" 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). +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 404 error pages tracking to stop. You should also remove the code that you inserted into your 404 error page template. diff --git a/docs/events-api.md b/docs/events-api.md index 8b6cd248..b33e35d7 100644 --- a/docs/events-api.md +++ b/docs/events-api.md @@ -43,7 +43,7 @@ curl -i -X POST https://plausible.io/api/event \ The raw value of User-Agent is used to calculate the *user_id* which identifies a [unique visitor](https://plausible.io/data-policy#how-we-count-unique-users-without-cookies) in Plausible. -User-Agent is also used to populate the _Devices_ report in your Plausible dashboard. The device data is derived from the open source database [device-detector](https://github.com/matomo-org/device-detector). If your User-Agent is not showing up in your dashboard, it's probably because it is not recognized as one in the _device-detector_ database. +User-Agent is also used to populate the **Browsers**, **Operating Systems** and **Devices** tabs in your Plausible dashboard. The device data is derived from the open source database [device-detector](https://github.com/matomo-org/device-detector). If your User-Agent is not showing up in your dashboard, it's probably because it is not recognized as one in the _device-detector_ database. The header is required but bear in mind that browsers and some HTTP libraries automatically add a default User-Agent header to HTTP requests. In case of browsers, we would not recommend overriding the header manually unless you have a specific reason to. diff --git a/docs/excluding-localstorage.md b/docs/excluding-localstorage.md index 3f6b0409..ea93d2a2 100644 --- a/docs/excluding-localstorage.md +++ b/docs/excluding-localstorage.md @@ -12,7 +12,7 @@ To prevent counting your visits, you can set a special `localStorage` flag in th ## To exclude your visits from being counted -Visit the website you'd like to exclude your visits from and open the developer tools in your browser. Right-click anywhere on your page and click "**Inspect**" (the wording may vary depending on your web browser) to open the developer tools. Alternatively, press the key `F12` on Firefox or Chrome or `Option+Command+i` on Safari. Then click the "Console" tab. +Visit the website you'd like to exclude your visits from and open the developer tools in your browser. Right-click anywhere on your page and click **Inspect** (the wording may vary depending on your web browser) to open the developer tools. Alternatively, press `F12` on Firefox or Chrome or `Option+Command+i` on Safari. Then click the "Console" tab. In Firefox, it looks like this: diff --git a/docs/excluding.md b/docs/excluding.md index e20bd8c1..0815e401 100644 --- a/docs/excluding.md +++ b/docs/excluding.md @@ -20,11 +20,11 @@ You can use our [official WordPress plugin](https://plausible.io/wordpress-analy * Go into the [site settings](website-settings.md) of the website you'd like to block your activity from -* Choose "**IP Addresses**" in the "**Shields**" entry in the left-hand menu +* Choose **IP Addresses** in the **Shields** entry in the left-hand menu Shields exclude traffic by IP -* Click on the "**Add IP Address**" button to add a new address to the block list +* Click on the **Add IP Address** button to add a new address to the block list Shields click to add IP address @@ -38,9 +38,9 @@ You can use our [official WordPress plugin](https://plausible.io/wordpress-analy * Once added to the block list, we will start blocking traffic from that specific IP address within a few minutes -* You can see the list of all the IP addresses that you're blocking at the moment. The entry in the list which has the "**YOU**" tag is your current IP address +* You can see the list of all the IP addresses that you're blocking at the moment. The entry in the list which has the **YOU** tag is your current IP address -* You can click on the "**Remove**" button next to that IP address to remove it from the blocklist +* You can click on the **Remove** button next to that IP address to remove it from the blocklist Shields IP blocked @@ -50,8 +50,8 @@ You can use our [official WordPress plugin](https://plausible.io/wordpress-analy If you prefer to only record traffic from specific hostnames (and block all the other traffic), you can do so in your site settings: * Visit the site settings area for the dashboard in question -* Choose "**Hostnames**" in the "**Shields**" entry in the left-hand menu -* Then click on the "**Add Hostname**" button to add a new hostname to your allow list +* Choose **Hostnames** in the **Shields** entry in the left-hand menu +* Then click on the **Add Hostname** button to add a new hostname to your allow list You can group your hostnames when adding them to the allow list: @@ -67,8 +67,8 @@ You can see the list of all the hostnames that you're allowing the traffic from If you prefer to block traffic from specific countries from being recorded in your dashboard, you can do so in your site settings as well: * Visit the site settings area for the dashboard in question -* Choose "**Countries**" in the "**Shields**" entry in the left-hand menu -* Then click on the "**Add Country**" button to add a new country to your block list +* Choose **Countries** in the **Shields** entry in the left-hand menu +* Then click on the **Add Country** button to add a new country to your block list Once added to the block list, we will start blocking traffic from that specific country within a few minutes. You can block up to 30 different countries. @@ -79,8 +79,8 @@ You can see the list of all the countries that you're blocking the traffic from. If you prefer to permanently block traffic from specific pages or sections of your site from being recorded in your dashboard, you can do so in your site settings: * Visit the site settings area for the dashboard in question -* Choose "**Pages**" in the "**Shields**" entry in the left-hand menu -* Then click on the "**Add Page**" button to add a new page to your block list +* Choose **Pages** in the **Shields** entry in the left-hand menu +* Then click on the **Add Page** button to add a new page to your block list * You can group different pages or dynamic URLs by using asterisks. For instance, if you'd like to block all the blog traffic from being recorded you can add something like (`/blog/*`) Once added to the block list, we will start blocking traffic from that specific page within a few minutes. You can block up to 30 different pages. diff --git a/docs/export-stats.md b/docs/export-stats.md index be53bbd7..b7f3dbd9 100644 --- a/docs/export-stats.md +++ b/docs/export-stats.md @@ -12,8 +12,8 @@ You can export your stats directly from the top chart of your Plausible dashboar 1. Select the date range in the top right of your Plausible dashboard to view the specific time period 2. [Filter your dashboard](filters-segments.md) by any metric that you wish to create a specific audience segment. Do include a goal in the filter (such as external link clicks, file downloads or custom events) if you're looking to export specific conversion metrics -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 +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 Exporting your website stats @@ -30,7 +30,7 @@ Note that for the export to be as quick as possible, the individual CSV files ar Here's how to export all the native data collected for a particular Plausible dashboard to date. This export method is slower, cannot be segmented and is best suited for data portability purposes. It also doesn't include any data that you imported from external sources. 1. Go to the Plausible Analytics [site settings](website-settings.md) for the website for which you'd like to export the data -2. In the "**Imports & Exports**" section, find the "**Export Data**" panel and click on the "**Export to CSV**" button +2. In the **Imports & Exports** section, find the **Export Data** panel and click on the **Export to CSV** button 3. Your export will be queued and we'll email you when it's ready for download. You'll have 24 hours to download the data after the export is ready ## Use the stats API diff --git a/docs/file-downloads-tracking.md b/docs/file-downloads-tracking.md index 80290b94..e6e0ee26 100644 --- a/docs/file-downloads-tracking.md +++ b/docs/file-downloads-tracking.md @@ -10,22 +10,22 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; If you use the file downloads tracking feature, then these count towards your billable monthly pageviews. ::: -File downloads tracking is essential for many site owners and Plausible helps you automate this process. Plausible can capture a file download event each time a link is clicked and that link contains a file extension. All the most common file extensions are tracked by default but you can also specify a custom list of file types to track. With our "**File downloads**" tracking you can: +File downloads tracking is essential for many site owners and Plausible helps you automate this process. Plausible can capture a file download event each time a link is clicked and that link contains a file extension. All the most common file extensions are tracked by default but you can also specify a custom list of file types to track. With our **File downloads** tracking you can: * See which files are clicked the most * See on which of your pages the particular file gets the clicks * Filter the dashboard by a file URL to see what type of visitors click the most (referral source, entry page, location, device, browser, OS) * Group your file downloads by any domain name or keyword -"**File downloads**" is an [optional enhanced measurement](script-extensions.md). If you want to track file downloads, here's how to enable it: +**File downloads** is an [optional enhanced measurement](script-extensions.md). If you want to track file downloads, here's how to enable it: ## 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). +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). Enable outbound file downloads tracking during onboarding -After you enable file downloads tracking on your site, all the file downloads will start being tracked and will be displayed in the "**Goals**" report of your Plausible Analytics dashboard. You'll see the "**File Download**" goal as soon as the first file download has been tracked. +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. Heads up: File download tracking only works for clicks that happen on your tracked pages. If you share a direct link to a file in an email or elsewhere, those opens won't be counted. Visitors need to arrive at your site first and click the link from there. @@ -35,7 +35,7 @@ The quickest way to start tracking file downloads is to use our [official WordPr ## See all the file download clicks in your dashboard -Click on "**File Download**" goal in the "**Goals**" report of your Plausible dashboard to see the full list of all clicks on all files and have your dashboard filtered by file download clicks only. You can see: +Click on **File Download** goal in the **Goals** tab of your Plausible dashboard to see the full list of all clicks on all files and have your dashboard filtered by file download clicks only. You can see: * The number of total file download clicks * The number of unique file download clicks @@ -47,7 +47,7 @@ Click on "**File Download**" goal in the "**Goals**" report of your Plausible da Click on a particular file URL to filter the dashboard by those clicks only and get the full overview of that specific file. -Want to group file downloads by the domain name or any other keyword? In the "**Filter**" button in the top right of your dashboard, choose "**Property**". Then select "**url**" (this includes all the file download URLs we have recorded) and use the "**contains**" option. Add whatever domain or keyword you want to group the file downloads by and click on the "**Apply Filter**" button. +Want to group file downloads by the domain name or any other keyword? In the **Filter** button in the top right of your dashboard, choose **Property**. Then select **url** (this includes all the file download URLs we have recorded) and use the "contains" option. Add whatever domain or keyword you want to group the file downloads by and click on the **Apply Filter** button. ## Which file types are tracked? @@ -55,7 +55,7 @@ Want to group file downloads by the domain name or any other keyword? In the "** Automatic file download tracking only works for files hosted on the same domain as the tracked site. Files served from a CDN, another domain, or an untracked subdomain will be tracked as [outbound link clicks](https://plausible.io/docs/outbound-link-click-tracking) instead. ::: -Our "**File downloads**" tracking captures a file download event each time a link is clicked with a document, presentation, text file, compressed file, video, audio or other common file type. Both internal and external files downloads are tracked. These file extensions are tracked by default: +Our **File downloads** tracking captures a file download event each time a link is clicked with a document, presentation, text file, compressed file, video, audio or other common file type. Both internal and external files downloads are tracked. These file extensions are tracked by default: `.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` @@ -83,6 +83,6 @@ Plausible also offers automated tracking for [outbound link clicks](outbound-lin ## 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). +You can control what data is collected in the **Site Installation** area of the **General** section in your [site settings](website-settings.md). After you disable file downloads tracking, we will automatically remove the goal called `File Download` from your site. diff --git a/docs/filters-segments.md b/docs/filters-segments.md index 47a5965f..94744377 100644 --- a/docs/filters-segments.md +++ b/docs/filters-segments.md @@ -14,7 +14,7 @@ You can mix and match filters too. So you can click on a referral source, then c Your current filters will be displayed on the top of your dashboard. You can click on the name of the existing filter to edit it or on the `x` icon to remove it. -You can remove all your filters by hitting the `Esc` key on your keyboard or by selecting `Clear all filters` in the filters menu (`***`). +You can remove all your filters by hitting the `Esc` key on your keyboard or by selecting **Clear all filters** in the filters menu (`***`).
-When you’re trying to understand and analyze your traffic, the "**Filter**" button is a powerful tool. It allows you to search, select multiple entries and it includes options "**is**", "**is not**", "**contains**" and "**does not contain**" to give you more flexibility when matching and segmenting your audience. Click on the "**Filter**" button on the top right of your dashboard to start adding filters. +When you’re trying to understand and analyze your traffic, the **Filter** button is a powerful tool. It allows you to search, select multiple entries and it includes options "is", "is not", "contains" and "does not contain" to give you more flexibility when matching and segmenting your audience. Click on the **Filter** button on the top right of your dashboard to start adding filters. ### Filter by multiple sources, countries, pages and more @@ -50,7 +50,7 @@ You can search for any metric such as a particular country, referral source or p You can exclude specific segments of traffic and only display the traffic that isn't part of the excluded segment. You can, for instance, exclude traffic from the United States so your dashboard only shows the visitors that aren't based in the USA. -Click on the "**Filter**" button, then select "**Country**" as your metric, choose "**is not**" (or "**does not contain**" as an alternative) and then select (or type) the name of the country you want to exclude. You can do the same for referral sources or any of the other metrics. +Click on the **Filter** button, then select **Country** as your metric, choose "is not" (or "does not contain" as an alternative) and then select (or type) the name of the country you want to exclude. You can do the same for referral sources or any of the other metrics.
Exclude traffic @@ -60,7 +60,7 @@ Click on the "**Filter**" button, then select "**Country**" as your metric, choo Want to group all your blog posts and analyze the traffic to the blog separately from the rest of your site? Or exclude traffic that has visited a specific section of your site such as your logged in pages or your order confirmation page? Or do you want to group all the traffic from a specific set of marketing campaigns? -You can group pages, sources, campaigns and more by using the "**Filter**" button. For instance, the "**Page**" menu within the filter button includes options "**contains**" and "**does not contain**". Put any specific keyword to group all of your pages that contain that keyword. +You can group pages, sources, campaigns and more by using the **Filter** button. For instance, the **Page** menu within the filter button includes options "contains" and "does not contain". Put any specific keyword to group all of your pages that contain that keyword. :::note Would you like your grouped pages to be permanently displayed in your dashboard? You can do so by using [pageview goals](pageview-goals.md). @@ -72,7 +72,7 @@ Would you like your grouped pages to be permanently displayed in your dashboard? ### Filter by subdomain or hostname -Want to filter by hostname so you can segment your stats to a specific subdomain only? You can do so by using the "**Filter**" button and choosing the "**Hostname**" entry within the menu. +Want to filter by hostname so you can segment your stats to a specific subdomain only? You can do so by using the **Filter** button and choosing the **Hostname** entry within the menu. You can choose to segment your traffic by any one specific hostname from the list, you can exclude any one specific hostname or even segment by hostnames that contain any specific word. @@ -84,7 +84,7 @@ Learn more on how Plausible [handles cross-subdomain tracking here](subdomain-ho ## How to save a segment -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 on the "**Save as segment**" button that is visible in the filters menu (`***`) that you see when your dashboard is filtered. +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 on the **Save as segment** button that is visible in the filters menu (`***`) that you see when your dashboard is filtered.
-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). +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). -Choose the type of segment you want to create, give it a recognizable name and click on the "**Save**" button. +Choose the type of segment you want to create, give it a recognizable name and click on the **Save** button. ### How to open a previously saved segment -Click the "**Filter**" button in the top-right corner of your dashboard to view your saved segments under the "**Segments**" heading. You can also search for specific segments. Click on a segment to open it in your dashboard. +Click the **Filter** button in the top-right corner of your dashboard to view your saved segments under the **Segments** heading. You can also search for specific segments. Click on a segment to open it in your dashboard.
Open a Segment
-Note that the "**Segments**" heading will only be visible in the "**Filter**" button after you save your first segment. +Note that the **Segments** heading will only be visible in the **Filter** button after you save your first segment. ### How to edit or delete a previously saved segment -Open a previously saved segment and click its name in the top line of your Plausible dashboard. Then, select "**Edit segment**" to add or remove filters. +Open a previously saved segment and click its name in the top line of your Plausible dashboard. Then, select **Edit segment** to add or remove filters.
-To save your changes, click the "**Update segment**" button. Use the arrow next to this button to save the existing segment as a brand new segment ("**Save as a new segment**) or to delete the existing segment ("**Delete segment**"). +To save your changes, click the **Update segment** button. Use the arrow next to this button to save the existing segment as a brand new segment (**Save as a new segment**) or to delete the existing segment (**Delete segment**). P.S. We've written an in-depth guide on effective use of audience segmentation, you can [read it here](https://plausible.io/audience-segmentation). diff --git a/docs/form-submissions-tracking.md b/docs/form-submissions-tracking.md index ea3ea253..d58b1aca 100644 --- a/docs/form-submissions-tracking.md +++ b/docs/form-submissions-tracking.md @@ -16,7 +16,7 @@ All detected form submissions are grouped under one goal, and you can analyze wh ## 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). +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). Enable form submissions tracking during onboarding @@ -29,7 +29,7 @@ The quickest way to start tracking form submissions is to use our [official Word ## See all the form submissions in your dashboard -Click on "**Form: Submission**" goal in the "**Goals**" report of your Plausible dashboard to see the full list of all form submissions and have your dashboard filtered by them. You can see: +Click on **Form: Submission** goal in the **Goals** tab of your Plausible dashboard to see the full list of all form submissions and have your dashboard filtered by them. You can see: * The number of total form submissions * The number of unique form submissions diff --git a/docs/funnel-analysis.md b/docs/funnel-analysis.md index b7b4da61..3493f478 100644 --- a/docs/funnel-analysis.md +++ b/docs/funnel-analysis.md @@ -28,29 +28,29 @@ Funnels also work across your main domain and its subdomains ([see more](subdoma ## How to set up the conversion funnel analysis -* Go into your [site settings](website-settings.md) and click on "**Funnels**" in the left-hand sidebar +* Go into your [site settings](website-settings.md) and click on **Funnels** in the left-hand sidebar -* Click the "**Add funnel**" button to create a funnel. +* Click the **Add funnel** button to create a funnel. -* Give your funnel a name in the "**Funnel name**" field. +* Give your funnel a name in the **Funnel name** field. * Define your funnel by adding the steps you expect a visitor to take before a conversion, a purchase or a sign up. These steps consist of [pageview goals](pageview-goals.md) and [custom event goals](custom-event-goals.md). You need to add a minimum of 2 steps and a maximum of 8 steps to create a funnel. If you want a step to match only a specific variation of a custom event, use a [property-filtered goal](/custom-props/for-custom-events#create-property-filtered-goals). -* By default, the "**Allow other activity in between funnel steps**" option is enabled, which creates a sequential funnel. Disable it to use strict order mode instead. +* By default, the **Allow other activity in between funnel steps** option is enabled, which creates a sequential funnel. Disable it to use strict order mode instead. -* Click on the "**Save**" button after you've specified the user journey you want to analyse +* Click on the **Save** button after you've specified the user journey you want to analyse Funnels appear at the bottom of your dashboard as soon as the first visit is tracked on the funnel steps. ## How to edit existing funnels -* Go into your [site settings](website-settings.md) and click on "**Funnels**" in the left-hand sidebar +* Go into your [site settings](website-settings.md) and click on **Funnels** in the left-hand sidebar * Click on the edit icon on the right-hand side of the funnel that you'd like to edit. -* Change the funnel name, edit the steps of your funnel and switch between sequential and strict order by toggling the "**Allow other activity in between funnel steps**" option +* Change the funnel name, edit the steps of your funnel and switch between sequential and strict order by toggling the **Allow other activity in between funnel steps** option -* Click on the "**Update Funnel**" button +* Click on the **Update Funnel** button ## What's next? diff --git a/docs/general.md b/docs/general.md index 7aa6743b..b90a0331 100644 --- a/docs/general.md +++ b/docs/general.md @@ -4,9 +4,9 @@ title: Change your reporting timezone 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 **Site timezone** field. 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. +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. diff --git a/docs/get-started-with-postman.md b/docs/get-started-with-postman.md index 69a44eb4..8922f448 100644 --- a/docs/get-started-with-postman.md +++ b/docs/get-started-with-postman.md @@ -8,7 +8,7 @@ Postman is a simple interface that you can use for [our stats API](stats-api.md) 1) Log in to your [Postman](https://www.postman.com/) account. -2) Go to "**My Workspace**" and then "**Collections**" to create a new collection. Feel free to give it a descriptive name such as "**Plausible Stats API**". +2) Go to **My Workspace** and then **Collections** to create a new collection. Feel free to give it a descriptive name such as **Plausible Stats API**. Create a new collection diff --git a/docs/ghost-integration.md b/docs/ghost-integration.md index a3415cab..869a14ae 100644 --- a/docs/ghost-integration.md +++ b/docs/ghost-integration.md @@ -4,19 +4,19 @@ title: How to add the script to your Ghost site import useBaseUrl from '@docusaurus/useBaseUrl'; -You can use the "**[Ghost code injection](https://ghost.org/integrations/plausible/)**" feature to add Plausible Analytics tracking code to your Ghost website same way you would add Google Analytics code or any other JavaScript code. +You can use the **[Ghost code injection](https://ghost.org/integrations/plausible/)** feature to add Plausible Analytics tracking code to your Ghost website same way you would add Google Analytics code or any other JavaScript code. In Ghost you can inject code across your entire site or on an individual post or page. Since Plausible needs to track analytics across your entire site, use the global code injection feature which can be found in the Ghost Admin settings menu. -* In the "**Menu**", click "**Settings**", and then "**Code Injection**". +* In the **Menu**, click **Settings**, and then **Code Injection**. Ghost code injection -* 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. +* 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. Add Plausible script to Ghost -* After adding your code, click on the "**Save**" button. +* After adding your code, click on the **Save** button. Now you can go to your website and verify whether Plausible Analytics script has been added and to your Plausible Analytics account to see whether the stats are being tracked. See here [how to verify the integration](troubleshoot-integration.md). diff --git a/docs/goal-conversions.md b/docs/goal-conversions.md index 3090606d..ce89f249 100644 --- a/docs/goal-conversions.md +++ b/docs/goal-conversions.md @@ -6,11 +6,11 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; Adding or searching for Goals -Goals allow you to track actions that you want your visitors to take on your site. Actions such as signing up to a newsletter, clicking on a "**Download**" button, registering for a trial account, purchasing a product, clicking on an external link, downloading a file or completing a checkout form of an ecommerce store. +Goals allow you to track actions that you want your visitors to take on your site. Actions such as signing up to a newsletter, clicking on a **Download** button, registering for a trial account, purchasing a product, clicking on an external link, downloading a file or completing a checkout form of an ecommerce store. By setting up custom events or pageviews as goals, you can track the number of conversions, conversion rate, referrer sources and entry pages that are driving conversions and the top pages that people convert on. You can also follow the visitor journey using funnels. For definitions of conversion rate, unique conversions and total conversions, see the [metrics definitions page](metrics-definitions.md). -Once a goal is configured, it appears in the "**Goals**" section of your dashboard after the first conversion is recorded. Then you can click on the particular goal to filter your dashboard by it and get all the insights on the traffic that has converted on that specific goal. +Once a goal is configured, it appears in the **Goals** section of your dashboard after the first conversion is recorded. Then you can click on the particular goal to filter your dashboard by it and get all the insights on the traffic that has converted on that specific goal. There are two core goal types: **pageview goals** (no code changes required) and **custom event goals** (require a code snippet or script). Everything else below builds on top of one of those two. diff --git a/docs/google-analytics-import.md b/docs/google-analytics-import.md index 9ae2134e..dbca4805 100644 --- a/docs/google-analytics-import.md +++ b/docs/google-analytics-import.md @@ -14,21 +14,21 @@ Here's how you can import your historical Google Analytics stats into your Plaus 1. Go to the Plausible Analytics [site settings](website-settings.md) for the website you'd like to import the data for. -2. In the "**Imports & Exports**" section, find the "**Import Data**" panel. You can link your Google account to your Plausible account by clicking on the "**Google Analytics**" button. +2. In the **Imports & Exports** section, find the **Import Data** panel. You can link your Google account to your Plausible account by clicking on the **Google Analytics** button. Import Google Analytics data into Plausible -3. After linking Plausible to your Google account, you'll see a drop-down selection menu listing all the existing Google Analytics properties associated with the connected Google account. Select the property that you'd like to import and click on the "**Continue**" button. +3. After linking Plausible to your Google account, you'll see a drop-down selection menu listing all the existing Google Analytics properties associated with the connected Google account. Select the property that you'd like to import and click on the **Continue** button. -4. On the next screen, you can click on the "**Confirm import**" button to start the data import process. The import should take no more than a few minutes for most sites but if you have a site with a lot of historical data, it may take up to a couple of hours to complete due to Google's API limits. You'll receive an email when the import has been completed. +4. On the next screen, you can click on the **Confirm import** button to start the data import process. The import should take no more than a few minutes for most sites but if you have a site with a lot of historical data, it may take up to a couple of hours to complete due to Google's API limits. You'll receive an email when the import has been completed. -5. Once you have received the email, the imported data will be visible in your Plausible dashboard alongside the native data. You can turn this off by opening the options menu (the **⋮** icon in the top right of the chart) and toggling off "**Include imported data**". +5. Once you have received the email, the imported data will be visible in your Plausible dashboard alongside the native data. You can turn this off by opening the options menu (the **⋮** icon in the top right of the chart) and toggling off **Include imported data**. ## Import multiple Google Analytics properties into the same Plausible dashboard If you'd like to import multiple Google Analytics properties into the same Plausible dashboard, please go through the process above again and choose a different property to import. You can import a maximum of 5 different properties into the same Plausible dashboard. -In the "**Imports & Exports**" section, you can see the overview of all your existing imports to that specific Plausible dashboard. For each import, we list the Google Analytics property ID, the number of pageviews imported and the time range that the import covers. +In the **Imports & Exports** section, you can see the overview of all your existing imports to that specific Plausible dashboard. For each import, we list the Google Analytics property ID, the number of pageviews imported and the time range that the import covers. ## How much data is imported? @@ -54,7 +54,7 @@ If you have strict data retention limits in place in Google Analytics (for insta ## How do I delete the imported data? -Data you have imported can be deleted by returning to your site's "**Imports & Exports**" settings page and clicking the "**Delete Import**" button in the "**Existing Imports**" section. This action won't affect the native data you have collected using our script directly. +Data you have imported can be deleted by returning to your site's **Imports & Exports** settings page and clicking the **Delete Import** button in the **Existing Imports** section. This action won't affect the native data you have collected using our script directly. Delete Google Analytics data from Plausible @@ -80,7 +80,7 @@ To get the number of unique visitors in a longer period of time (say one month) ### UTM sources -Google Analytics aggregates UTM source under the "**source**" dimension and they don't expose a separate "**UTM source**" dimension from their API. This is why we cannot show UTM sources imported from Google Analytics. +Google Analytics aggregates UTM source under the **source** dimension and they don't expose a separate **UTM source** dimension from their API. This is why we cannot show UTM sources imported from Google Analytics. ### Goals @@ -92,7 +92,7 @@ We can import your traffic split between the different browsers but you can't dr ### Exit pages -Google Analytics 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** tab for imported data. ### Scroll Depth diff --git a/docs/google-search-console-integration.md b/docs/google-search-console-integration.md index a100e20c..4c6eec2c 100644 --- a/docs/google-search-console-integration.md +++ b/docs/google-search-console-integration.md @@ -14,9 +14,9 @@ Here’s how you can add your site to Search Console and then integrate the Sear ## Add your site to the Google Search Console -_If your site is already set up on Google Search Console, you can skip to the "**[Allow Plausible Analytics to access your Search Console](#allow-plausible-analytics-to-access-your-search-console)**" step._ +_If your site is already set up on Google Search Console, you can skip to the **[Allow Plausible Analytics to access your Search Console](#allow-plausible-analytics-to-access-your-search-console)** step._ -Head over to [Google Search Console](https://search.google.com/search-console/) and click on the "**Start now**" button. If you don’t have any sites set up on Google Search Console already, you will be taken straight to the form to add a new domain. Otherwise, you can open the drop down on the top left and select "**Add property**". +Head over to [Google Search Console](https://search.google.com/search-console/) and click on the **Start now** button. If you don’t have any sites set up on Google Search Console already, you will be taken straight to the form to add a new domain. Otherwise, you can open the drop down on the top left and select **Add property**. You can either create a domain property or a URL prefix property on Google Search Console. Check out [their documentation](https://support.google.com/webmasters/answer/34592?hl=en) to understand the difference between these options. Plausible Analytics works with both options, so it’s completely up to you. @@ -36,9 +36,9 @@ Follow the provided instructions depending on which verification method you’ve ## Allow Plausible Analytics to access your Search Console -Open the [site settings area](website-settings.md) for your website in your Plausible account and go into the section called "**Integrations**": +Open the [site settings area](website-settings.md) for your website in your Plausible account and go into the section called **Integrations**: -In the "**Google Search Console Integration**" module, click on the "**Continue with Google**" button which will take you through to Google’s authentication flow to get the necessary permissions. +In the **Google Search Console Integration** module, click on the **Continue with Google** button which will take you through to Google’s authentication flow to get the necessary permissions.
Continue with Google @@ -62,7 +62,7 @@ You then need to grant Plausible Analytics a permission to view your Search Cons Next up, you are back in Plausible Analytics site settings where you should see a select box where you can choose which property from Google Search Console to integrate your Plausible Analytics dashboard with. Properties that start with `sc-domain:` represent domain properties and others are URL prefix properties in Search Console. -Once you’ve selected your property, click on the "**Save**" button. At that point, the integration should be fully functional. +Once you’ve selected your property, click on the **Save** button. At that point, the integration should be fully functional.
Choose which property from Google Search Console to integrate with @@ -70,7 +70,7 @@ Once you’ve selected your property, click on the "**Save**" button. At that po ### I get the "Invalid Grant" error -Google may return the "**invalid_grant**" error message for several reasons: +Google may return the **invalid_grant** error message for several reasons: - Google has a limit of 50 live tokens. When you try to add the 51st site, the site you added first will be disconnected from your Plausible account and so on. This is a limitation on Google's side so if you have more than 50 different sites in your Search Console, you will need to split them between different Google accounts to get them into Plausible at the same time - Your permissions for the specific site may have been changed or revoked in your Google account. Please check your Search Console account and make sure you still have the user permission to the site in question @@ -83,7 +83,7 @@ Please make sure you tick the "View Search Console data for your verified sites" ## Check your search query data in Plausible Analytics -Look at your site’s "**Top Sources**" report in your Plausible Analytics dashboard, click on "**Google**" in the list and you should see the keyword terms coming through. If you click on the "**Details**" button, you can also see the number of impressions, CTR and position for each keyword term. And you can also [filter your dashboard](filters-segments.md) by page, country or device and see the Search Console keyword terms for that segment of your audience only. +In the **Sources** tab in your Plausible Analytics dashboard, click on **Google** and you should see the keyword terms coming through. Click the expand icon in the top right to also see the number of impressions, CTR and position for each keyword term. And you can also [filter your dashboard](filters-segments.md) by page, country or device and see the Search Console keyword terms for that segment of your audience only.