Organizations
An organization is the top-level workspace in PicaDeck. It is the billing and access boundary that contains all your projects, team members, and settings.
When you first sign up, you create an organization during onboarding. You can belong to multiple organizations — for example, one for your company and another for a personal side project.
Organizations manage:
- Billing and subscription (plans, seats, invoices)
- Team membership and roles
- Project ownership
- Organization-wide audit logs
Roles & Permissions
PicaDeck uses a two-level permission system: organization roles and project roles.
Organization Roles
| Role | Permissions |
|---|---|
| Owner | Full access to everything. Can manage billing, delete the organization, and transfer ownership. Only one owner per org. |
| Admin | Full access to all projects and members. Can invite/remove members, change roles, and manage project settings. Cannot delete the organization. |
| Member | Access only to projects they are explicitly added to. Cannot see other projects or manage organization settings. |
Admin override
Project Roles
| Role | Permissions |
|---|---|
| Admin | Full project access: edit schema, manage all branches, change settings, manage project members |
| Edit | Can edit the schema and create their own branches. Cannot manage project settings or members |
| View | Read-only. Can view the schema but cannot make any changes |
Inviting Team Members
There are two ways to add team members:
Organization Invitations
Invite someone to your entire organization from the Team page. Enter their email address and they will receive an invitation email. Once accepted, they become an organization member and can be added to specific projects.
Project-Level Access
Add existing organization members to a specific project from the project's team settings. Choose their role (Admin, Edit, or View) to control their access level.
Pending invitations count toward your organization's seat limit. If you are on the free plan with 3 seats and already have 2 members plus 1 pending invitation, you will need to upgrade before inviting more people.
Branch Access
In git-enabled projects, branch editing permissions follow a clear hierarchy:
- Branch creator — can always edit their own branch
- Project Admin — can edit any branch in the project
- Organization Admin/Owner — can edit any branch in any project within the organization
All other project members with View or Edit roles can see branches but cannot edit branches they did not create (unless they are a project or org admin).
Real-Time Editing
When multiple team members are working on the same project simultaneously, PicaDeck provides real-time collaboration features:
- Live cursors — see where your teammates are working on the canvas
- Instant sync — changes made by one user appear immediately for all connected users
- Presence indicators — see who is currently online and viewing the same project
Tip
Comments & Threads
You can add comments directly on the schema canvas to discuss design decisions with your team. Comments are organized into threads for focused conversations.
Common use cases for comments:
Comment threads can be resolved once the discussion is complete, keeping your schema view clean.