Domain management

Domain verification allows Business and Enterprise workspace owners to claim ownership over an email address domain associated with their workspace. This unlocks domain management settings like configuring SAML SSO for your workspace, building Notion integrations using link previews, and controlling who can create workspaces (for Enterprise plans only).

Domain verification does not impact your billing.

In the workspace settings, navigate to the Identity & Provisioning tab and complete the following steps to verify your domain.

• Within the Domain Management section, click the Add domain button.

• Type in the domain that you wish to verify and click the Next button. The domain will be added to the list of your verified domains in a pending verification (designated with the color gray).

• Update the DNS record by following the instructions in the Verification Modal.

• After updating the DNS record, Click Verify to notify Notion to check your DNS record.

• Once verification is complete, you’ll receive a confirmation email and the domain will be displayed in green.

If you’re building an integration with Notion, like Link Previews, you’ll need to verify your domain in the integration management page (this action will not take place in Notion).

You can find the full instructions in our Developer Guides →

Prerequisites for customizing workspace creation permissions

• Workspace must be on the Enterprise Plan

• You must be a workspace owner

• You have verified at least one domain. Instructions for domain verification can be found above →

You can customize permissions for who can create new workspaces using your verified domain(s).

Use the dropdown to switch between the following options:

• Select Anyone to allow any user with your verified domain to create a new workspace.

• Select Workspace owners to prevent users with your verified domain from creating new workspaces.

Once a domain is verified, workspace owners on the Enterprise Plan can transfer, delete, or claim ownership over non-Enterprise workspaces created by users with their verified domain.

Prerequisites for viewing claimable workspaces

• You must be a workspace owner on the Enterprise Plan

• Verified domain is a non-educational domain

What workspaces are eligible?

• Single-member workspace

  • The workspace creator’s email belongs to the verified corporate domain

• Multi-member workspace

  • The workspace creator’s email belongs to the verified corporate domain (the creator does not need to be a current member of the space)

  • At least one current workspace owner (either the creator or someone else) is using the verified corporate email address

• Workspace is not on the Enterprise Plan

Once a workspace owner verifies a domain, an automated email will be sent to all workspace owners of workspaces created with that domain, notifying them that their workspaces are eligible to be claimed.

During this 14 day notification period, workspace owners can only request ownership transfers on single-member workspaces. They will be unable to delete single-member workspaces or claim multi-member workspaces.

After a domain is verified, users who create new workspaces with a verified domain will be notified upon creation that their workspace is eligible to be claimed.

Once a domain is verified, Enterprise workspace owners can view all non-enterprise workspaces created by users with their verified domain. This view can be found in your workspace security settings in the Identity & provisioning tab under the Domain management section.

For each workspace, this view includes:

• Workspace name

• Plan type

• Number of members

• Workspace owners

• Created at

• Created by

Workspace owners can take the following actions on their claimable workspaces:

1. Request ownership change on single-member workspaces

2. Delete single-member workspaces

3. Claim multi-member workspaces

Workspace owners can also export the list of claimable workspaces as a CSV.

• Click on Settings & members in your sidebar and go to Identity & provisioning.

• Click on Browse workspaces and then Export to CSV in the top right.

With domain management, workspace owners on the Enterprise Plan can request a change in ownership transfer on single-member workspaces using a verified domain to a non-corporate email address. This is especially helpful when users created a workspace using a corporate email address, but use the workspace primarily for personal projects.

Workspace owners need to initiate the change request in the workspace security settings. In the workspace settings, navigate to the Identity & Provisioning tab and Browse Workspace in the Domain management section. From the claimable workspace view, complete the following steps:

1. Select the single-member workspace that you would like to change

2. In the ••• menu, select Require Account Change

3. Provide a contact email for questions from users about the request and confirm the action

In the view, the workspace will enter a pending state.

When the change request is submitted, an email notification will be sent to the workspace owner of the selected workspace and the user will not be able to access their workspace until they have completed the remaining transfer steps as follows:

1. Log into the workspace

2. Follow the instructions and change email address associated with the account to a non-corporate email address. Note: while a single-member workspace ownership change is requested, the user cannot change the email associated with their user account

3. A verification code will be sent to the email address to confirm the user’s ownership of the account. Enter this verification code in the workspace

4. An automated email will be sent once the change is complete

Prerequisites for changing a workspace ownership

• You must be a workspace owner on an Enterprise Plan

• The workspace to be changed must be on a single-member

With domain management, Enterprise workspace owners can more easily govern how a verified domain is used and where related projects are stored on Notion. When an employee leaves a company, Enterprise workspace owners can delete their single member workspaces to cleanup old content while remaining compliant.

Prerequisites for deleting a workspace

• You must be a workspace owner on the Enterprise Plan

• The domain was verified at least 14 days ago

• Workspace to be deleted must be a single-member workspace that is either free or not delinquent on payments.

In the workspace settings, navigate to the Identity & provisioning tab and select Browse workspaces in the Domain management section. From the claimable workspace view, complete the following steps:

1. Select the single-member workspace you would like to delete

2. Click the ••• menu and select Delete workspace

3. Provide a contact email for questions from users about the deletion and confirm the action

In the workspace view, a Recover button will appear next to the selected workspace. When the deletion is initiated, an email notification will be sent to the workspace owner of the selected workspace. The single member workspace owner will immediately lose access to their workspace.

Workspace was deleted by mistake?

If you receive an email notification about a workspace that has been deleted accidentally instead of transferred, please reach out to your respective Enterprise workspace owner provided in the email notification directly.

To recover a deleted workspace, the Enterprise workspace owner that initiated the deletion can do this in the workspace settings: navigate to the Identity & provisioning tab and select Browse workspaces in the Domain management section. From the claimable workspace view, complete the following steps:

1. Go to the single-member workspace you would like to recover.

2. Click on the Recover button for the workspace and confirm

3. In the view the workspace will now appear without the recover button.

4. The owner of the single-member workspace will regain access to their workspace and their workspace content will be restored.

The workspace owner of the single-member workspace selected for deletion can request Notion Support extend the recovery timeframe by 30 days from the day they contact Support. After the recovery timeframe expires workspace data will be permanently deleted.

When a workspace is recovered, all page content in the workspace will be restored and the single-member workspace owner will regain access.

The following content cannot be recovered:

• Favorites

• Guest access

• Configured integrations (Bots)

• Domains (custom Notion domains)

With domain management, workspace owners can establish authorized workspaces for employees to collaborate by claiming ownership over eligible multi-member workspaces.

In the workspace security settings, navigate to the Identity & provisioning tab and Browse workspaces in the Domain management section. From the claimable workspaces view, complete the following steps:

1. Select the multi-member workspace that you would like to claim ownership of

2. Verify payment information (only credit card payments are supported)

3. Review and accept the billing implications of claiming the workspace

When the claim of ownership is processed:

• Claimed workspace will be upgraded to the Enterprise Plan

• Workspace owner that claimed the workspace will become the only workspace owner

• Previous workspace owners are downgraded to members (workspace owners can re-assign roles and permissions as necessary)

Prerequisites for claiming a workspace

• You must be a workspace owner on the Enterprise Plan

• The domain was verified at least 14 days ago

• The claimed workspace must be multi-member

  • The workspace creator’s email belongs to the verified corporate domain (the creator does not need to be a current member of the space)

  • At least one current workspace owner (either the creator or someone else) is using the verified corporate email address

• Workspace is not on the Enterprise Plan

Benefits of claiming a workspace

• Standardize billing across Notion workspaces (all workspaces will be invoiced separately)

• Configure Enterprise workspace security settings to be in compliance with your company policies

• Regulate the roles and responsibilities for the workspace (workspace owner, membership admin, member)

The workspace consolidation tool is available to Enterprise customers through their Notion Account Management team. Learn more about workspace consolidation support here.