Organizations
An organization is the top-level workspace in ByteHide. It holds your projects, members, teams, integrations, billing and security settings. One account can belong to several organizations and switch between them.
What Belongs to an Organization
| Scope | Examples |
|---|---|
| People | Members, their roles, teams and pending invitations |
| Work | Projects and the tools enabled in them (Code, Vault, Shield, App runtime, Audit), plus AI runtime and Agentic runtime |
| Configuration | Integrations, developer API tokens, SSO and SCIM |
| Billing | Plan, subscriptions, invoices and usage. Each organization is billed on its own |
Nothing is shared between organizations. A person who belongs to two organizations has a separate role in each.
Create an Organization
- Click your avatar in the top-right corner.
- Under Organization, click Add new organization.
- Fill in the form and click Create.
| Field | Description |
|---|---|
| Display Name | The name shown in the console and to invited members. Required |
| Slug | URL-friendly identifier. It fills in from the display name as you type. Lowercase letters, numbers and single hyphens only. Required |
| Description | Optional, up to 255 characters |
You become the Owner of the new organization, and ByteHide creates its default team, general. The console then opens its settings.
Owners only
Add new organization appears only when you are an Owner of the organization currently selected. Each new organization starts its own plan and trial.
Switch Organization
Click your avatar and choose an organization under Organization. The current one is marked. The console reloads with the projects, members and settings of the organization you picked.
Organization Settings
Open Settings → Organization. The menu on the left shows only the sections your role can use:
| Section | What it holds | Who sees it |
|---|---|---|
| Settings | Name, slug, description and avatar | Owner, Manager |
| Teams & Members | Teams, members and invitations. See Members and Teams | Everyone (the members list needs Owner or Manager) |
| Integrations | Organization-wide connectors | Owner, Manager |
| Developer | API tokens and authorized apps | Owner, Manager |
| Security | SSO, verified domains and SCIM. See Single Sign-On | Owner, Manager (only owners can change it) |
| Billing | Plan, payment, billing address, billing emails and invoices | Owner, Billing |
| Usage | Consumption per product | Owner, Billing |
| Danger Zone | Leave the organization | Everyone |
General Settings
In Settings → Organization → Settings, under Organization Settings:
- Slug, Display Name and Description. Click Save changes to apply them, or Reset to discard your edits.
- Avatar: click Upload an image (PNG or JPEG, up to 800 KB), or Remove to clear it.
Changing the slug
The slug is part of the SSO Sign-in URL shown in Security. If your organization uses SSO and you change the slug, update the Home page URL of the ByteHide app in Entra ID.
Ownership
The Owner role has full control of the organization, including billing, SSO and every member's role. An organization can have more than one owner, and it always keeps at least one:
- Only an owner can make someone else an owner, by inviting them with the Owner role or changing an existing member's role.
- You cannot change your own role or remove yourself from the members list.
- The last owner cannot be removed or demoted, by another owner or by SCIM.
To hand an organization over, make the new person an owner first. Then they, or you, can change your role, or you can leave.
Billing Scope
Billing is per organization. The plan, subscriptions, payment method and invoices of one organization do not affect another. Only Owner and Billing roles can open Billing and Usage.
Your plan includes a number of members. On paid plans the Members tab shows how many are included and how many free seats remain. When there are none left, the invitation dialog warns that an extra member is charged once the invitation is accepted, and that this charge is not refunded.
Leave an Organization
- Open Settings → Organization → Danger Zone.
- Tick Understood and wish to proceed and enter a Reason.
- Click Leave Organization.
Leaving is permanent. To come back you need a new invitation. If you are the only owner, the page says "You are the only owner of this organization. Cannot leave organization." Make another member an owner first.
Delete an Organization
The console has no option to delete an organization. To delete one, contact ByteHide support from Support in the console.
Next Steps
Members and Teams
Invite people and assign roles
Projects
Create a project and pick its tools
Single Sign-On
Sign in with Microsoft Entra ID