Permission Tiers and Access Control
Flux uses a sophisticated multi-layered permission system to control access to projects. Understanding how these layers work together helps you manage collaboration effectively across individuals, organizations, and enterprises.
Permission Types
Flux supports four distinct permission levels that determine what actions users can perform on a project:
Edit (Write)
Users with edit permissions have full control over the project. They can:
- Modify the schematic and PCB layout
- Add, remove, or change components
- Update design rules and constraints
- Manage project settings
- Make changes to any aspect of the design
View (Read)
Users with view permissions can access the project but cannot make changes. They can:
- View all project content
- Navigate through schematic and PCB views
- Download project files
- Review design specifications
View access is ideal for stakeholders who need visibility into project progress without editing capabilities.
Comment
Users with comment permissions can view the project and participate in discussions. They can:
- View all project content
- Add, edit, and resolve comments
- Participate in design reviews
- View chat history and contribute to conversations
Comment access enables collaboration without allowing direct changes to the design, perfect for reviewers and consultants.
None
Users with no permissions cannot access the project at all. This is the default state for any user not explicitly granted access.
Permission Layers
Flux implements a four-layer permission system that provides flexible access control for different scenarios. These layers work together to determine a user's effective permissions for any given project.
Layer 1: Anonymous Access
The anonymous access layer controls whether anyone on the internet can view your project. When you make a project public:
- Anyone with the project URL can access it
- No Flux account is required
- This is ideal for sharing example projects or open-source designs
By default, all projects are private, meaning anonymous access is disabled.
Layer 2: User-Specific Permissions
You can grant specific permissions to individual Flux users. This layer provides fine-grained control over who can access your project and what they can do.
To grant user-specific permissions:
- Open the share menu from the toolbar
- Add users by their email address or Flux handle
- Select the appropriate permission level (Edit, View, or Comment)
User-specific permissions override anonymous access settings. For example, you can keep a project private (no anonymous access) while granting specific users view or edit access.
Layer 3: Organization Permissions
When a project is owned by an organization, organization membership affects access permissions. There are two roles within an organization:
Organization Owners have administrative control over the organization and all its projects. They can:
- Manage organization members
- Set default permissions for organization projects
- Access all projects owned by the organization
- Configure organization-wide settings
Organization Members receive access to projects based on the organization's default permission settings. By default, organization members receive edit access to all organization-owned projects, but this can be customized per project.
The organization owner can set a default permission type for members (typically Edit, but can be set to View, Comment, or None). This default applies to all organization members unless overridden by user-specific permissions.
Learn more about organizations
Layer 4: Enterprise Permissions
Enterprise accounts add an additional layer of access control for large organizations. When an organization belongs to an enterprise:
Enterprise Owners have access to all projects across all organizations within the enterprise. This ensures enterprise administrators maintain visibility and control.
Enterprise Members receive access through their organization's default organization. The enterprise owner can set a default permission level that applies to all enterprise members (typically Edit). This permission flows through the enterprise's default organization to grant members access to projects.
The relationship works as follows:
- An enterprise owns multiple organizations
- One organization is designated as the enterprise's default organization
- All enterprise members automatically belong to the default organization
- Projects owned by the default organization inherit enterprise member permissions
This structure enables large organizations to manage access control at scale while maintaining security and proper segregation of projects across different teams.
Permission Inheritance and Precedence
When multiple permission layers apply to a user, Flux uses the most permissive access level. Here's how permissions are evaluated:
- Enterprise owner access: Enterprise owners always have full access to all projects within their enterprise
- Organization owner access: Organization owners have full access to projects owned by their organization
- User-specific permissions: Explicitly granted permissions override organization and anonymous settings
- Organization member permissions: Organization members receive the default permission set by the organization owner
- Enterprise member permissions: Enterprise members receive access through the default organization's settings
- Anonymous access: If enabled, provides the baseline access level for anyone with the URL
For example:
- If a project has anonymous View access enabled, but you grant a specific user Comment access, that user will be able to comment
- If an organization member has the default Edit permission, but you grant them View permission specifically, they will only be able to view (the specific permission overrides the default)
Managing Project Access
For Individual Projects
To manage access to an individual project:
- Click the share button in the toolbar
- Configure anonymous access (public/private)
- Add specific users and assign permission levels
- Review current access in the sharing panel
For Organization Projects
Organization owners can set default permissions that apply to all organization members:
- Configure the default member permission type (Edit, View, Comment, or None)
- This setting applies to all projects owned by the organization
- Override defaults for specific projects or users as needed
For Enterprise Projects
Enterprise administrators should:
- Set default member permissions at the enterprise level
- Organize projects across appropriate organizations
- Use the default organization for projects that should be accessible to all enterprise members
- Create separate organizations for projects that need restricted access
Security Best Practices
When managing permissions:
- Start with minimal access: Grant the least privilege necessary for each user's role
- Use organizations for teams: Group related users into organizations to simplify permission management
- Review access regularly: Periodically audit who has access to sensitive projects
- Leverage enterprises for scale: If you're managing multiple teams, enterprise accounts provide the structure you need
- Document access policies: Clearly communicate your organization's access control policies to team members
Related Documentation
- Sharing and Permissions - Basic sharing concepts and how to share projects
- Organizations - Setting up and managing organizations
- Collaboration Deep Dive - Best practices for team collaboration