Manage organization metadata, custom publish domains, and subscription plans.
Organization settings is a modal dialog (OrgSettingsDialog) for org-wide configuration that does not belong on the day-to-day Projects, Members, or Groups tabs. It is the same surface whether you open it from the org home, the organizations list, or the workspace menu.
Not available for local organizations.
Open settings
| Entry point | Control |
|---|---|
| Organization home → Projects tab | Settings (header, next to org name) |
| Organizations list | Gear icon on the org row |
| Workspace menu → organization | Settings |
Role required: org_owner or org_admin (org_member does not see these entry points).
On desktop the dialog uses a left sidebar (General, Domains, Plans). On mobile it opens as a bottom drawer with horizontal tabs. Each time the dialog opens, General is selected first.
1. General
Role required: org_owner or org_admin
| Field | Notes |
|---|---|
| Name | Display title (up to 100 characters). Edit → confirm with ✓ or cancel with ✕. |
| Alias | Globally unique org key (1–20 characters). Organization aliases are editable; Personal orgs use a read-only personal key — see Personal Organization. |
Fields save inline on confirm. A key change affects org-scoped links that embed the alias — update bookmarks and integrations after renaming.
Delete organization
Role required: org_owner only. Hidden for personal organizations.
| Rule | Behavior |
|---|---|
| Membership | Delete is enabled only when the org has at most one member. If others remain, remove them on the Members tab first. |
| Confirmation | Type DELETE in the confirmation dialog. |
| Effect | Permanently removes the organization and all folders, projects, branches, domains, and associated data. |
Deletion is irreversible. Export or archive critical projects before deleting an Organization.
2. Domains
Role required: org_owner or org_admin
Custom hostnames for published project sites. Project-level Publish settings attach projects to domains configured here.
Add a domain
- Enter a hostname (for example
docs.example.com) and Add - Configure DNS using the values shown on the domain card:
- CNAME — host → platform target
- TXT verification (while pending) —
_iomodel-verify.{hostname}→ verification token
- Check DNS — polls verification; status becomes Verified or stays Pending with a short message
Copy buttons beside each DNS value copy the record to the clipboard.
Domain card
| Element | Behavior |
|---|---|
| Status | Verified or Pending badge |
| Linked projects | Projects currently published on this domain (links open the project in Studio). A default badge marks the domain’s default project when set. |
| Delete | Removes the domain from the org. Projects remain on *.iomodel.net; re-link them from each project’s Publish tab if needed. |
If no domains exist yet, add one here before enabling custom hosts in Project settings → Publish.
3. Plans
Role required: visible to all org members who can open settings; plan requests require org_owner or org_admin and a verified email.
Content matches the org Plans tab on the organization home — both show the same plan options.
| Control | Behavior |
|---|---|
| Plan cards | Free, Pro, and Enterprise with feature lists; current plan is highlighted. |
| See full pricing details | Opens the public pricing page in a new tab. |
| Make Request | Submits an upgrade request for Pro or Enterprise (disabled for non-admins or unverified email). |
| Pending request | Shows review status, submit date, and contact email. Admins can Edit & resend or Withdraw. |
Entitlements from the active plan (for example GitHub Sync) apply org-wide. See Teams and Access for how roles interact with plan-gated features.
Role summary
| Action | org_owner | org_admin | org_member |
|---|---|---|---|
| Open settings | Yes | Yes | No |
| Edit name / alias | Yes | Yes | No |
| Manage domains | Yes | Yes | No |
| Request plan change | Yes | Yes | No |
| Delete organization | Yes | No | No |
Use the Plans tab on the org home when you only need billing; use Settings when you also need General or Domains in one place.
Next: Teams and Access.
Last updated on