Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/form-submissions-tracking.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ If you use the form submissions tracking feature, then these count towards your

Plausible can automatically detect and track when visitors submit forms on your website. This feature helps you measure engagement with contact forms, signup forms, and other key conversion points without adding custom code.

When Form submissions tracking is enabled, Plausible automatically detects all forms across your site and records submissions as a single goal. This means you don’t need to configure individual goals for each form Plausible handles it for you.
When Form submissions tracking is enabled, Plausible automatically detects all forms across your site and records submissions as a single goal. This means you don’t need to configure individual goals for each form: Plausible handles it for you.

All detected form submissions are grouped under one goal, and you can analyze where conversions happen by filtering results by page path or referrer. For example, if the same form appears on multiple pages, Plausible will show how many submissions occurred on each specific page.

Expand Down
4 changes: 2 additions & 2 deletions docs/google-analytics-import.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ description: "Import your historical Google Analytics 4 data into Plausible Anal
"name": "Why are the numbers higher in Plausible than in Google Analytics?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Plausible does not require cookie consent and is not blocked by most browser-level tracking protection. GA4 is blocked by Safari ITP, Firefox Enhanced Tracking Protection and many ad blockers. Plausible natively captures more traffic, particularly from privacy-conscious users."
"text": "Plausible does not require cookie consent and is blocked far less often than Google Analytics by browser-level tracking protection. GA4 is blocked by Safari ITP, Firefox Enhanced Tracking Protection and many ad blockers. Plausible natively captures more traffic, particularly from privacy-conscious users."
}
},
{
Expand Down Expand Up @@ -208,7 +208,7 @@ GA4 uses modeled data and consent mode to estimate traffic for users who decline

**Numbers are higher in Plausible than in GA4**

Plausible does not require cookie consent and is not blocked by most browser-level tracking protection. GA4 is blocked by Safari ITP, Firefox Enhanced Tracking Protection and many ad blockers. Plausible natively captures more traffic, particularly from privacy-conscious users.
Plausible does not require cookie consent and is blocked far less often than Google Analytics by browser-level tracking protection. GA4 is blocked by Safari ITP, Firefox Enhanced Tracking Protection and many ad blockers. Plausible natively captures more traffic, particularly from privacy-conscious users.

**Import appears to complete but data is missing**

Expand Down
10 changes: 5 additions & 5 deletions docs/sso.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,21 +26,21 @@ Once SSO is configured and your users have valid identities with your chosen ide
<img alt="SSO Login Form" src={useBaseUrl('img/sso-login-form.png')} />
</div>

After entering the email, they are redirected to identity provider's portal. The provider validates their identity if they haven't logged in there yet or uses an already validated identity from an existing session. The identity information (email, name) is then securely sent back to Plausible. At that point, their account is automatically created in Plausible—no manual setup needed.
After entering the email, they are redirected to identity provider's portal. The provider validates their identity if they haven't logged in there yet or uses an already validated identity from an existing session. The identity information (email, name) is then securely sent back to Plausible. At that point, their account is automatically created in Plausible. No manual setup needed.

### Provisioning

When someone logs in through SSO, we will first check if there's an existing team member with a matching email address and SSO configuration. If a match is found, they're logged in as that user. If not, a new user would be created automatically and added to the team whose configured SSO domain matches the email’s domain.

By default, new members are assigned the Viewer role, but you can change it as needed.

A user signing in through SSO can only belong to one team. Team assignment is based on the domain in their email address. Each SSO domain must be uniquea single domain can't be linked to more than one team at once.
A user signing in through SSO can only belong to one team. Team assignment is based on the domain in their email address. Each SSO domain must be unique: a single domain can't be linked to more than one team at once.

You can read more about domains at [SSO Domains](#sso-domains).

### Security

When you configure SSO for your team for the first time, existing members can still log in using their email and password. However, once a member signs in via your identity provider, their account becomes SSO-onlythey can no longer use standard login credentials.
When you configure SSO for your team for the first time, existing members can still log in using their email and password. However, once a member signs in via your identity provider, their account becomes SSO-only: they can no longer use standard login credentials.

Standard and SSO users can coexist on the same team as long as the "Force Single Sign-On" option is disabled.

Expand Down Expand Up @@ -176,7 +176,7 @@ Providing this fallback is important to provide a way to resolve issues with mis

## SSO Domains

Before it's possible to log in through SSO, you need to add at least one domain and verify its ownership using one of the three available methods. SSO will not work—even if SAML is fully configured—until a domain is added and verified.
Before it's possible to log in through SSO, you need to add at least one domain and verify its ownership using one of the three available methods. SSO will not work until a domain is added and verified, even if SAML is fully configured.

When someone tries to log in via SSO, Plausible checks the domain part of their email address (the part after the “@”) against your configured domains. If a match is found, the user is redirected to the appropriate identity provider for authentication.

Expand Down Expand Up @@ -223,7 +223,7 @@ Following settings are available:
- **Session timeout (minutes)**: Session timeout for users logged in through SSO. Maximum is 12 hours. Default is 360 minutes (6 hours).

:::tip Session timeouts in Plausible and in identity provider are different things
SSO account session timeout in Plausible is always counted relative to the time of last login, not user activity. Unlike standard accounts, simply staying active won’t extend the session. However, this doesn’t mean users need to manually log in again when the session expires. When the timeout is reached, Plausible automatically redirects to your identity provider. If the user's session is still valid there, they’re seamlessly returned to Plausibleright back to the last page they visited. Plausible's session timeout is typically shorter than the one configured at your identity provider. This helps keep user access in sync. For example, if a user's identity is removed at the provider level, their Plausible session will expire shortly after, limiting unauthorized access.
SSO account session timeout in Plausible is always counted relative to the time of last login, not user activity. Unlike standard accounts, simply staying active won’t extend the session. However, this doesn’t mean users need to manually log in again when the session expires. When the timeout is reached, Plausible automatically redirects to your identity provider. If the user's session is still valid there, they’re seamlessly returned to Plausible, right back to the last page they visited. Plausible's session timeout is typically shorter than the one configured at your identity provider. This helps keep user access in sync. For example, if a user's identity is removed at the provider level, their Plausible session will expire shortly after, limiting unauthorized access.
:::

## Team Management
Expand Down
9 changes: 5 additions & 4 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -85,9 +85,10 @@ module.exports = {
{ label: 'Migrate from GA4', href: 'https://plausible.io/migrate-from-google-analytics' },
{ label: 'vs Matomo', href: 'https://plausible.io/vs-matomo' },
{ label: 'vs Cloudflare', href: 'https://plausible.io/vs-cloudflare-web-analytics' },
{ label: 'GA4 accuracy comparison', href: 'https://plausible.io/most-accurate-web-analytics' },
{ label: 'Why pay for analytics?', href: 'https://plausible.io/paid-analytics-vs-free-ga' },
{ label: 'Is Plausible right for you?', href: 'https://plausible.io/when-not-to-use-plausible' },
{ label: 'GA4 accuracy', href: 'https://plausible.io/most-accurate-web-analytics' },
{ label: 'Paid vs free', href: 'https://plausible.io/paid-analytics-vs-free-ga' },
{ label: 'Right for you?', href: 'https://plausible.io/when-not-to-use-plausible' },
{ label: 'How to choose', href: 'https://plausible.io/privacy-friendly-web-analytics' },
{ label: 'WordPress plugin', href: 'https://plausible.io/wordpress-analytics-plugin' },
{ label: 'Google Tag Manager', href: 'https://plausible.io/gtm-template' },
{ label: 'Looker Studio', href: 'https://plausible.io/looker-studio-connector' },
Expand All @@ -103,7 +104,7 @@ module.exports = {
{ label: "What's new", href: 'https://plausible.io/changelog' },
{ label: 'Status', href: 'https://plausible.io/status' },
{ label: 'GitHub', href: 'https://github.com/plausible/analytics' },
{ label: 'Twitter', href: 'https://twitter.com/plausiblehq' },
{ label: 'X (Twitter)', href: 'https://twitter.com/plausiblehq' },
{ label: 'Bluesky', href: 'https://bsky.app/profile/plausible.io' },
{ label: 'Mastodon', href: 'https://fosstodon.org/@plausible' },
{ label: 'LinkedIn', href: 'https://www.linkedin.com/company/plausible-analytics/' },
Expand Down
Loading