Overview
By default, all verified domains are available to every project within your team. Project limits allow you to restrict a domain so that only specific projects can send emails from it.
This feature is useful when you have multiple projects with different purposes and want to ensure that sensitive or brand-specific domains are only used by authorized projects.
How It Works
Domains can be in one of two states:
| State | Description |
|---|
| Unrestricted | Domain can be used by any project in your team (default) |
| Restricted | Domain can only be used by explicitly selected projects |
When a project attempts to send an email using a restricted domain it doesn’t have access to, the API will return an error:
The domain 'mail.acme.com' is not available for use by this project.
Configuring Project Limits
You can configure which projects have access to a domain from the domain settings page.
Restricting a Domain
- Navigate to Domains in your dashboard
- Click on the domain you want to restrict
- In the project limits section, select the projects that should have access
- Save your changes
Removing Restrictions
To make a domain available to all projects again, simply remove all project selections. An empty selection means the domain is unrestricted and available to all projects in your team.
Access Control
When a domain is restricted to specific projects, it affects who can manage the domain:
| Role | Can Edit Restricted Domain? |
|---|
| Team Owner | Always |
| Team Member | Only if they have access to at least one of the restricted projects |
Team members who don’t have access to any of the restricted projects will see the domain as read-only and cannot modify its settings.
API Reference
You can also manage project limits programmatically using the Team API. See the Update Domain Projects endpoint for details.