Change your domain name
Please follow these steps if you have changed the domain name of your site and would like your new domain name to be displayed in your Plausible dashboard. You won't lose any of your historical stats in this process.
Use the site ownership transfer functionality instead
How to change your site domain in Plausible site settings?
Once you change the domain in your Plausible site settings, you may have to take additional steps to ensure your Plausible integration continues to work seamlessly. Please see the list below.
Here's how to change the domain name of a site in your Plausible account:
-
Go to the "General" section of the website settings in your Plausible account
-
Click on the "Change domain" button in the "Site domain" section
-
Type in your new domain name. Please, remove
httpsandwwwfrom the domain, just keep the hostname (yourdomain.com). For example, if your new domain ishttps://www.yourdomain.comthen the part to enter in the "Domain" field isyourdomain.com -
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.
Domain change checklist
In this section, we'll highlight everything that might need additional action after a successful domain change in Plausible.
1. Ensure your tracking is working
First and foremost, you'll need to make sure your stats are still tracking. Whether or not you need to take any action here depends on your setup.
| Installation type | How do I know if I'm using this? | Required action to ensure continuous tracking |
|---|---|---|
| Script tag installation | The snippet on your website contains the word | No action required |
| WordPress plugin | If your website is on WordPress, you're most likely using the plugin as that's the recommended installation method. | Update the site domain in your plugin settings |
| NPM package | You're using the @plausible-analytics/tracker library | Update the init options, e.g. init({ domain: "your_new_domain.com", ... }) |
| Legacy tracking snippet | The Plausible snippet on your website includes the data-domain attribute. | Update the snippet's data-domain attribute value, e.g. <script src="https://plausible.io/js/plausible.js" data-domain="your_new_domain.com" ...> |
To make the necessary changes to your tracking, you'll have a transition period of 72 hours, during which we will count your stats using both the old and the new domain. After 72 hours, the old domain is cleared from our database and any new traffic sent with the old domain will be rejected.
2. Update Stats API integrations
Stats API requests depend on the domain as an argument. API requests made after a domain change with the old domain will fail. Update any Stats API based integrations to use the new domain.
3. Ensure you update bookmarked and shared links
As soon as you change the domain in Plausible, any links to your site analytics dashboard or site settings that you might have bookmarked or shared will stop working. These will be available at the new root URL https://plausible.io/<your_new_domain>. There is no automatic redirect in place from the old root URL to the new one.