Add and manage users

Needed permissions: owner

Add users to your Piwik PRO account and manage their account settings. You can invite and remove users, set their initial permissions, change their language and region, and reset two-factor authentication.

In this article, we’ll show you how to add users and manage their account settings and access.

Invite a user

To invite a user, follow these steps:

1. Go to Menu > Administration.

2. Navigate to Users.

3. Click Invite a user.

4. Enter the user’s email address.

5. Select the user’s language.

Adding a user in Piwik PRO account

6. Click Send invitation.

7. The user will receive an email with an activation link. They can then click Create a password to log in and set up the account.

Note: If SSO is turned on for your account, the user will log in through your identity provider. They won’t need to set another password.

8. After sending the invitation, set permissions for the user. By default, new users don’t have access to any site, app, meta site or meta app.

9. Done.

If the invitation email doesn’t arrive

Ask the user to:

  • Check their spam folder.
  • Make sure the email address used for the invitation is correct.

Set up permissions

After you invite a user, set the permissions they need. By default, new users don’t have permission to any site, app, meta site or meta app.

To set up permissions for the user, follow these steps:

1. Type the user’s name to find them.

Searching users in Piwik PRO

2. Select the user to open their profile.

Selecting a user in Piwik PRO account

3. If the user should have full access to the account, turn on Owner access.

Note: Owners have full access to the account. When Owner access is turned on, separate permission settings aren’t shown.

Truning on owner access in Piwik PRO

4. In Modules, choose which modules the user can access.

Managing module access in Piwik PRO

Note: Turning off access to the Administration module only hides it from the user interface. You can still access Administration functions through the API.

5. In Groups, add the user to any groups whose permissions you want them to inherit. You can also remove the user. Read more

Note: To create groups or manage group permissions, see Add a group.

Adding a user to a group in Pwik PRO account

6. In Sites & apps > User permission, choose the permission for each site or app.

User permission in site or app permissions settings in Piwik PRO

7. In Meta sites & apps, set permissions for any meta sites or meta apps the user needs to access.

Permission for meta sites or apps in Piwik PRO account

8. Done. To learn how direct and group permissions work together, or what each permission level allows, see Manage user permissions.

Change a user’s language and region

You can set the language and regional format used for a user.

To change these settings, follow these steps:

1. Go to Menu > Administration.

2. Navigate to Users.

3. Select the user you want to work with.

Selecting a user in Piwik PRO account

4. Select a Language.

5. Select a Region.

selecting user region in Piwik PRO

6. Check Format preview to see how dates, times, numbers and currencies will appear with the selected language and region.

format preview in Piwik PRO user account

7. Done.

Reset two-factor authentication

Reset 2FA if the user needs to set up two-factor authentication again. After the reset, they’ll need to configure 2FA the next time they sign in.

To reset 2FA, follow these steps:

1. Go to Menu > Administration.

2. Navigate to Users.

3. Select the user to open their profile.

Selecting a user in Piwik PRO account

4. Click Reset 2FA.

resetting 2FA in a user's view in Piwik PRO account

5. Click Reset to confirm.

6. Done. The user will now need to set up 2FA again.

Delete a user

To delete a user, follow these steps:

1. Go to Menu > Administration.

2. Navigate to Users.

3. Select the user you want to remove.

4. Click Delete.

Delete a user in Piwik PRO account

5. Click Delete to confirm.

The user will no longer have access to your Piwik PRO account.