Organization & Teams
Organization Hierarchy
Ocriva is structured around Organizations and Projects. An organization is the top-level container — it owns billing, storage, and team membership. Projects live inside an organization and scope the actual work: templates, document uploads, and processing history.
Organization (Your Company)
├── Billing & Credits (shared across all projects)
├── Team Members (org-wide roles and permissions)
├── Project: Invoice Processing
│ ├── Templates
│ ├── Uploads & Processing History
│ └── Project-specific settings
├── Project: Receipt Scanning
│ ├── Templates
│ ├── Uploads & Processing History
│ └── Project-specific settings
└── Project: Contract Analysis
├── Templates
├── Uploads & Processing History
└── Project-specific settingsEach organization is fully isolated — data, billing, and storage do not cross organization boundaries. If you work with multiple companies, create a separate organization for each one.
Creating an Organization
- Sign in to Ocriva and navigate to the Organizations page.
- Click Create Organization.
- Fill in the required fields:
- Name — must be unique across the platform
- Description — optional, helps team members understand the org's purpose
- Industry — optional, used for analytics and recommendations
- Click Create — you automatically become the owner.
- A storage bucket is provisioned automatically for your organization.
NOTE
You must belong to at least one organization before you can create projects, upload documents, or use templates. The organization is the root of all activity on the platform.
Organization Settings
Navigate to Organization → General to update:
- Name — display name for the organization
- Description — internal description
- Logo — shown in the UI and on exports
- Website — optional external URL
- Location — geographic region
Navigate to Organization → Billing to manage:
- Subscription plan and limits
- Credit balance and top-ups
- Payment method (Stripe)
Navigate to Organization → Settings to configure:
- Allow Invites — enable or disable member invitations
- Max Members — cap on total org members (default: 10)
- Require Approval — new members must be approved before joining
- Default Role — role assigned to newly invited members
Team Roles
Every organization member is assigned one of four roles:
| Role | Description | Default Permissions |
|---|---|---|
| Owner | Full control over the organization | All permissions, including delete org |
| Admin | Manage members, settings, and billing | All permissions except deleting the organization |
| Member | Day-to-day work with templates and documents | Create/edit templates, upload docs, view history |
| Viewer | Read-only stakeholder access | View processing history only |
NOTE
An organization must always have at least one active Owner. If the last owner leaves, the organization becomes unmanageable. Always maintain at least two owners for continuity.
Permissions
Permissions can be customized per member beyond their default role. The table below shows the defaults:
| Permission | Owner | Admin | Member | Viewer |
|---|---|---|---|---|
| Create Templates | ✅ | ✅ | ✅ | ❌ |
| Edit Templates | ✅ | ✅ | ✅ | ❌ |
| Delete Templates | ✅ | ✅ | ❌ | ❌ |
| View Processing History | ✅ | ✅ | ✅ | ✅ |
| Manage Members | ✅ | ✅ | ❌ | ❌ |
| Manage Billing | ✅ | ✅ | ❌ | ❌ |
| View Analytics | ✅ | ✅ | ❌ | ❌ |
TIP
Permissions can be customized per individual member. For example, you can grant a Member the ability to view analytics, or restrict an Admin from managing billing — without changing their role. Use Organization → People, click a member, and toggle individual permissions.
Inviting Team Members
- Go to Organization → People.
- Click Invite Member.
- Enter the member's email address.
- Select a role: Admin, Member, or Viewer.
- Optionally expand Permissions to customize individual permission toggles.
- Click Send Invite — the member receives an email invitation and their status is set to
pending. - Once the member accepts the invite, their status changes to
active.
TIP
Use the Viewer role for stakeholders — executives, clients, or auditors — who need to see results but should not be able to modify templates or trigger document processing.
Managing Members
From Organization → People you can:
- Change role — select the member, use the role dropdown to assign a new role
- Customize permissions — click the member row to expand individual permission toggles
- Suspend a member — temporarily disables access without removing them; status becomes
suspended - Remove a member — permanently removes access; status becomes
left
WARNING
Removing or suspending a member immediately revokes their access to all projects within the organization. Any documents they uploaded or templates they created are retained — only their access is removed.
Projects
Projects organize work within an organization by use case. Each project has its own:
- Templates — extraction configurations specific to that project
- Uploads — documents uploaded within that project
- Processing History — results scoped to that project
- Members — a subset of org members can be assigned to specific projects
Credits are billed at the organization level and shared across all projects. There is no per-project credit budget by default.
Creating a Project
- Go to Organization → Projects.
- Click Create Project.
- Enter a name and optional description.
- Click Create — the project is created under the current organization.
- Navigate into the project to start adding templates and uploading documents.
Organization Limits
Resource limits are determined by your subscription plan:
| Resource | Tracked By |
|---|---|
| Team members | maxMembers (default: 10) |
| Projects | maxProjects |
| Templates per project | maxTemplates |
| Storage | maxStorage (GB) |
| Webhook endpoints | maxWebhookEndpoint |
IMPORTANT
If you reach a limit (e.g., maxMembers), you will not be able to invite additional members until you upgrade your plan or remove existing members. Visit Organization → Billing to review and upgrade your subscription.
Best Practices
- Use descriptive names for organizations and projects (e.g., "Acme Corp — Finance" rather than "Org 1").
- Apply the principle of least privilege — assign the minimum role necessary for each team member.
- Use separate projects for distinct document types (invoices, contracts, receipts) to keep templates and processing history organized.
- Review member permissions periodically, especially after team changes.
- Maintain at least two owners per organization to avoid losing administrative access.
- Enable Require Approval if your organization handles sensitive documents and you want to control who joins.
