Sharing
Share build configurations with team members, groups, units, or your entire organization.
Sharing Options
Variants (conversations) can be shared with:
| Target | Description |
|---|---|
| User | Share directly with a specific person |
| Group | Share with all members of a group |
| Unit | Share with all members of a unit |
| Team | Share with all members of a team |
| Organization | Share with entire organization |
Share Permissions
Each share has a permission level:
| Permission | Access |
|---|---|
| view | Read-only access to the configuration |
| edit | Can modify the configuration |
Sharing with Users
Share directly with a colleague:
- Open the conversation
- Click Share button
- Select User
- Enter their email address
- Select permission (view/edit)
- Click Share
The user will see the shared configuration in their sidebar.
Sharing with Groups
Groups simplify sharing with multiple people:
- Create a group (e.g., “QA Team”, “Reviewers”)
- Add members to the group
- Share with the group
All current and future group members receive access.
Creating Groups
- Go to organization settings
- Open Groups tab
- Click Create Group
- Enter name and description
- Add members
- Save
Managing Groups
| Action | Steps |
|---|---|
| Add member | Open group → Add Member → Select user |
| Remove member | Open group → Click X next to member |
| Delete group | Open group → Delete (removes shares) |
Sharing with Units
Share with an entire unit:
- Open the conversation
- Click Share
- Select Unit
- Choose the unit
- Select permission
- Share
All unit members, regardless of team, receive access.
Sharing with Teams
Share with a specific team:
- Open the conversation
- Click Share
- Select Team
- Choose unit, then team
- Select permission
- Share
Only members of that specific team receive access.
Organization-Wide Sharing
Share with everyone in your organization:
- Open the conversation
- Click Share
- Select Organization
- Select permission
- Share
All organization members receive access.
Same-Organization Validation
Sharing is restricted to your organization:
- Cannot share with users in other organizations
- Email addresses are validated against organization membership
- Cross-tenant sharing is blocked at API level
This ensures data stays within your organization.
Managing Shares
View Current Shares
- Open the conversation
- Click Share
- See list of current shares
Remove a Share
- Open share dialog
- Find the share to remove
- Click the X or Remove button
- Confirm removal
Change Permission
- Open share dialog
- Find the share
- Click the permission dropdown
- Select new permission
- Save
Share Notifications
When you share with someone:
- They see the item in their sidebar
- Email notification (if enabled)
- In-app notification
Shared With Me
View items shared with you:
- Look for the Shared section in sidebar
- Or filter conversations by “Shared with me”
Shared items show who shared them and what permission you have.
Best Practices
Use Groups for Recurring Shares
If you frequently share with the same people:
- Create a group
- Add the members
- Share with the group
- Update membership as needed
Permission Guidelines
| Scenario | Recommended Permission |
|---|---|
| Code review | view |
| Collaboration | edit |
| Reference/template | view |
| Active development | edit |
| Audit/compliance | view |
Audit Sharing
Periodically review who has access:
- Open configuration
- Review share list
- Remove outdated shares
- Verify permissions are appropriate
Sharing Workflows
Review Workflow
Creator → share (view) → Reviewer → comments → Creator updatesCollaboration Workflow
Team Lead → share (edit) → Team Members → concurrent editingTemplate Workflow
Platform Team → share (view) → All Teams → fork for customizationTroubleshooting
Can’t Find User to Share With
- Verify they’re in your organization
- Check email address spelling
- Ask them to accept organization invite
User Can’t See Shared Item
- Verify share was created
- Check permission level
- User may need to refresh
- Confirm organization membership
Can’t Edit Shared Item
- Check your permission (view vs edit)
- Contact owner to change permission