Subdomains

Subdomains enable hierarchical organization and more granular access control within a domain. They help large domains stay structured while limiting access to specific assets and users.

Create a Subdomain

Navigate to Domain Management
- Open the Domains management page.
- In the parent domain where you want to create a subdomain, click the three-dot menu and select Create subdomain.
Configure the Subdomain
- Name: Enter a clear and descriptive name.
- Description (optional): Add details about the subdomain’s purpose or scope.
- Add Assets: Choose how to add assets—via filter conditions or by selecting data assets manually.
  
  📝 Note: A subdomain can only include assets that already belong to the parent domain.
- Add Users: Search for users and assign their roles (e.g., Domain Viewer, Domain Editor) within the subdomain.
Save
- Click Save.
  
  Your new subdomain appears immediately under its parent domain.

Edit a Subdomain

To edit an existing subdomain:

On the Domains management page, find the subdomain.
Click the three-dot menu and select Edit.
Make the necessary changes.
Click Save subdomain.

You can also use subdomains in other settings such as Access Tokens, SSO (single sign-on), Users, and Sifflet Access.

Navigation & Display Behavior

Domain Switching:

You can switch between your assigned domains and subdomains using the dropdown menu at the top of all Sifflet pages.
Restricted Access View:

If you only have access to a subdomain (e.g., Subdomain 1):
- You see the parent domain in the hierarchy, but it appears as restricted.
- You cannot access or manage the parent domain or any sibling subdomains.

Role & Permission Model

A user can belong to the parent domain and multiple subdomains.
Roles can differ at each level (e.g., Domain Viewer in the parent domain, Domain Editor in a subdomain).
Access is enforced per asset.
If a user belongs to multiple subdomains or roles, Sifflet applies the highest-permission role.