Setting up domain access

Domain access lets you claim domain(s) to be associated with your Writer organization, in order to enable seamless access for users from your company. Domain access is required before setting up domain discoverability, or setting up SSO and/or SCIM.

What's in this article?

• What is domain access?
• Claiming domains
• Password access
• Managing claimed domains

What is domain access?

Domain access lets you claim domain(s) to be associated with your Writer organization, in order to enable seamless access for users from your company. With domain discoverability, coworkers who sign up for Writer with a company email address can join your Writer organization with the appropriate permissioning and controls. Claiming a domain is also required in order to set up SSO and SCIM.

From the Admin menu on the left select Access & provisioning and you’ll be taken to the domain access settings.

Claiming domains

Claiming a domain lets Writer know that your organization owns that domain exclusively. Here are a few important things to note before claiming a domain:

• You can only claim the domain of the email address you're signed in with. So, if you're signed in with mary@writer.com, you'll be able to claim the "writer.com" domain. To claim a domain that you are not signed in with, reach out to support@writer.com.
• You’ll need to claim a domain before you can set up SSO and SCIM.
  • To learn more about setting up SSO, click here.
• If your organization has already claimed one domain, but you’re signed in with a different company email domain that is also valid, you can claim that domain too. So, if you’ve claimed “writer.com” but you’re signed in as mary@qordoba.com, you can claim the qordoba.com domain as well. Follow the same steps as claiming a new domain.
• If you try to claim a domain that’s already claimed by another Writer organization, you’ll see a message letting you know. You can reach out to support@writer.com in order to claim this domain across multiple organizations.
• If you’re signed in with a personal email (like Gmail or Yahoo), you’ll see a message saying the domain can’t be claimed.

How to claim a domain & configure domain discoverability

Go to Admin > Access & provisioning > Domain access.

If your domain hasn't been claimed yet, you'll see a button that says Claim domain.

Select Claim domain to open the domain discoverability settings.

When domain discoverability is toggled on, users logging in with an email address using your claimed domain will be asked to join your org:

Setting up default teams and roles

By default, new members joining through domain discoverability will be added to a specific team and role. You can always edit a user’s role later on. As a security best practice, we recommend setting the default role as “Member". Learn more about access roles here.

You can select multiple teams from the Default team menu if you’d like new users to be added to more than one team.

Select Save.

Password access

Password access determines determines whether new users joining with an email in your domain will require admin approval to join your organization or not.

To configure password access, go to Admin > Access & Provisioning and select the Access tab.

By default, password access is set to on, unless you have SSO configured.

If you let users sign in with a password, you can decide if new users can join your Writer org automatically, or if an org admin needs to approve the request first.

NOTE: These settings apply to all domains claimed by your organization.

Managing claimed domains

Once your domain is claimed, you can edit the previous options by selecting the icon in the upper right of the domain module. If you run into any issues, please reach out to support@writer.com.