Permissions Management

Dystr uses a hierarchical permissions system: Organizations contain Workspaces, and members are granted access at both levels.

Organization Structure

Organizations are the top-level container for your projects. Each Organization can have:

• Multiple Workspaces.
• Multiple members with different access levels.
• Organization-wide settings and policies.

Organization Roles

Members in an Organization can have one of three access levels:

‍

Managing Organization Members

[Screenshot: Organization Settings > Members tab]

To manage Organization members:

1. Click the Settings icon in the top right of your Organization page.
2. Navigate to the Members tab.
3. For each member, you can:
   • Adjust their role using the dropdown menu.
   • Remove them from the Organization.
   • View their last active time.

Adding New Members

[Screenshot: Invite Members dialog]

To invite new members to your Organization:

1. Click "Invite Members" in the top right of your Organization page.
2. Enter their email address.
3. Select their role (Administrator, Editor, or Viewer).
4. Click "Send Invite."

Workspace Access Control

Each Workspace can be configured with two visibility levels:

‍

Managing Workspace Access

[Screenshot: Share Workspace dialog]

To manage access to a specific Workspace:

1. Open the Workspace.
2. Click "Share Workspace" in the top right.
3. Choose the visibility level:
   • Select "Invite-Only" to control exactly who has access.
   • Select "Everyone at [Organization]" to make it accessible to all organization members.
4. For invite-only Workspaces, you can add specific members:
   • Enter their email address.
   • They must already be a member of the Organization.
   • Their Organization role sets their maximum permission level.

Best Practices

• Start with restrictive permissions and expand access as needed.
• Regularly review Organization members and their roles.
• Use Organization-wide access for general resources.
• Reserve invite-only access for sensitive projects.
• Remember that Organization administrators always have access to all Workspaces.

Common Tasks

• Adding a new team member: Invite them to the Organization first, then add them to specific Workspaces if needed.
• Creating a shared resource: Create a Workspace and enable Organization-wide access.
• Setting up a private project: Create a Workspace, keep it invite-only, and add only required team members.

Related Links

• Workspaces
• Data Policy

‍