From 52049b361f0293c9a5c33baa129d5592b52b258d Mon Sep 17 00:00:00 2001
From: Marko Saric <marko@plausible.io>
Date: Thu, 1 Oct 2026 14:20:04 +0200
Subject: [PATCH] more detailed info

---
 docs/billing.md                   | 6 +++++-
 docs/custom-props/introduction.md | 4 ++++
 docs/download-invoices.md         | 2 +-
 docs/excluding.md                 | 2 ++
 docs/file-downloads-tracking.md   | 2 ++
 docs/google-analytics-import.md   | 2 ++
 docs/troubleshoot-integration.md  | 2 ++
 7 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/docs/billing.md b/docs/billing.md
index 117ef2b0..17f29b84 100644
--- a/docs/billing.md
+++ b/docs/billing.md
@@ -97,7 +97,7 @@ If you're purchasing on behalf of a business, click **Add VAT number** on the se
 
 <img class="border" alt="Add VAT number at checkout" src={useBaseUrl('img/v2/add-vat-number-during-checkout.webp')} />
 
-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. Other invoices that were already issued stay as they were. [More on Paddle's VAT handling →](https://paddle.com/support/which-countries-does-paddle-charge-vat-for/)
 
 ## How do I change my VAT number?
 
@@ -197,6 +197,10 @@ Ad blockers and privacy extensions can interfere with the payment form. Try disa
 - Disable any VPN or browser extensions before attempting payment
 - If your card details are correct and no 3DS prompt was issued, try subscribing using a different email address
 
+**Change plan button missing on an Enterprise plan**
+
+If you're on a custom (**Enterprise**) plan, the **Change plan** button is hidden in the **Subscription** section while a payment is past due or your subscription is paused. Update your payment method under **Billing details** so Paddle can charge your card again. Once the payment goes through, the **Change plan** button is back.
+
 Have a billing question not covered here? [Contact us](https://plausible.io/contact).
 
 <CtaBox
diff --git a/docs/custom-props/introduction.md b/docs/custom-props/introduction.md
index c6c064dd..2fcf54e4 100644
--- a/docs/custom-props/introduction.md
+++ b/docs/custom-props/introduction.md
@@ -37,6 +37,10 @@ Note that you must ensure that no personally identifiable information (PII) is s
 
 If you're confused whether the information you're sending to us qualifies as PII, look at the [explanations and examples](https://plausible.io/blog/pii-examples) in our guide.
 
+:::note
+Specific custom property values can't be deleted on their own once they've been recorded. If personal data was sent by mistake, the only way to remove it is to [reset your site data](/reset-site-data), which clears all the stats collected for that site.
+:::
+
 ## `(none)` values
 
 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.
diff --git a/docs/download-invoices.md b/docs/download-invoices.md
index 5496a71c..2f16127e 100644
--- a/docs/download-invoices.md
+++ b/docs/download-invoices.md
@@ -17,7 +17,7 @@ To save a PDF copy, use your browser's **Print** command and select **Save as PD
 
 ## 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. Your company details and VAT number are added to invoices from then on. Other invoices that were already issued stay as they were. [More on Paddle's VAT handling →](https://paddle.com/support/which-countries-does-paddle-charge-vat-for/)
 
 ## Change your billing address
 
diff --git a/docs/excluding.md b/docs/excluding.md
index 8fe42e64..31ffaaf6 100644
--- a/docs/excluding.md
+++ b/docs/excluding.md
@@ -82,6 +82,8 @@ Once added to the block list, we will start blocking traffic from that specific
 
 You can see the list of all the pages that you're blocking the traffic from. Click on the "Remove" button next to that page to remove it from the blocklist.
 
+Page rules match the page path only, not the query string. A rule for `/pricing` blocks `/pricing?ref=newsletter` too, and you can't block a page based on its query parameters here.
+
 ## Exclude visits by hostname
 
 If you prefer to only record traffic from specific hostnames (and block all the other traffic), you can do so in your site settings: 
diff --git a/docs/file-downloads-tracking.md b/docs/file-downloads-tracking.md
index 26720c3c..79937636 100644
--- a/docs/file-downloads-tracking.md
+++ b/docs/file-downloads-tracking.md
@@ -62,6 +62,8 @@ Our **File downloads** tracking captures a file download event each time a link
 
 Note that clicks on download links within `svg` elements are not tracked.
 
+A link is detected as a file download by the file extension at the end of its path, such as `/files/report.pdf`. Some CMSs serve files from addresses without an extension, such as `/web/content/1234`, so clicks on those links aren't detected. To track them, [add a CSS class name](custom-event-goals.md#add-a-css-class-name-to-the-element-you-want-to-track-on-your-site) to the link and track it as a custom event.
+
 ## What if I want to track a different file type?
 
 You can also specify a custom list of file types to track with a `file-types` attribute tag. With this, you can track other file types not present in our default list. Say you only want to track `.js` and `.py` files, you can pass the following argument to `plausible.init`:
diff --git a/docs/google-analytics-import.md b/docs/google-analytics-import.md
index b6bb32f8..c0a46532 100644
--- a/docs/google-analytics-import.md
+++ b/docs/google-analytics-import.md
@@ -84,6 +84,8 @@ If you'd like to import multiple Google Analytics properties into the same Plaus
 
 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.
 
+Each import brings in the whole Google Analytics property. It can't be split by hostname, so if one property tracked several sites, the data for all of them goes into the one Plausible site you import it into.
+
 ## How much data is imported?
 
 Data is imported in aggregate for each date, from your first Google Analytics visitor until your first Plausible Analytics visitor. This is to avoid double-counting visits. 
diff --git a/docs/troubleshoot-integration.md b/docs/troubleshoot-integration.md
index b8023c83..df4f0495 100644
--- a/docs/troubleshoot-integration.md
+++ b/docs/troubleshoot-integration.md
@@ -304,6 +304,8 @@ Common causes during testing:
 - Another device on the same network visited the site recently
 - You tested multiple UTM links without waiting 30 minutes between each
 
+If your campaign link points to a URL that redirects, for example to another subdomain, the redirect must keep the query string. If it drops it, the UTM parameters never reach the page where Plausible runs. The visit is then attributed to its referrer, or shows as **Direct / None** when there's no referrer.
+
 To test UTM attribution reliably, use a device and network combination that has not visited your site in the past 30 minutes. Mobile data on a phone that hasn't visited the site recently is the most reliable option. Check the **Campaigns** tab after the visit to confirm attribution.
 
 ---