Organisation Settings

An organisation groups several projects, and the people who work on them, under a single owner. It is what makes organisation-wide SSO, shared styling and cross-project team management possible.

Organisations are set up by DeveloperHub rather than created from the editor. If you would like your projects grouped under one, contact us.

Opening Organisation Settings

To open Organisation Settings, open the user menu in the editor top navigation and choose Organisation settings. Only the organisation owner sees this option.

You can also press ⌘/⌃ + K and type the name of the pane you're looking for.

Settings Groups

Organisation Settings is organised into groups. Each group contains panes:

• People: Team. Everyone in the organisation, and whether they can sign in.

• Usage: Statistics. User and project counts over the last three months.

• Customisation: Custom CSS. One stylesheet shared across projects that opt in.

• Single Sign-On: SSO status. A read-only summary of your SSO configuration.

Managing members is limited to the organisation owner.

Team

Organisation Settings → Team lists everyone in your organisation. Each member shows their name, e-mail address, when they were last active, and a status of Owner, Active or Disabled.

Use the search box to filter by name or e-mail address. Use Sort by to order the list by Last active or Name.

"Last active" is the last time the member opened DeveloperHub.

Disabling a Member

Disabling a member keeps their account and all of their work, but stops them getting in. It is the right choice when someone leaves a team temporarily, or when you want to cut access without losing the history attributed to them.

To disable a member:

• Open Organisation Settings → Team.

• Click the chevron at the end of the member's row and choose Disable member.

• Confirm your choice.

Access is revoked immediately. Any sessions they have open end straight away, and they cannot log back in by any method, including SSO and passwordless login. They will see the message "Your account has been disabled. Please contact your organisation administrator."

Everything else is preserved: their account, name, e-mail address and project memberships stay as they are, so page history and the activity log keep attributing past work to them.

The organisation owner cannot be disabled.

Re-enabling a Member

To re-enable a member, click the chevron at the end of their row and choose Enable member. This takes effect straight away with no confirmation step. They keep the same account and the same project access they had before, and simply log in again.

Disabling and re-enabling a member are both recorded in the activity log of every organisation project that member belongs to.

Disable or Deprovision?

Both actions are on the same menu, and they are very different:

Disabling is the only one of the two that keeps someone out. A disabled member is refused on every login route, including SSO.

Deprovisioning deletes the account, but it does not stop the person signing in again. Deprovisioning is only available on organisations that use SSO, so the next time they authenticate through your identity provider they are treated as somebody new and an account is created for them. Where your SSO connection adds users to all projects by default, they regain access immediately.

For what deprovisioning removes, see Deprovisioning Users. It cannot be undone.

Statistics

Organisation Settings → Statistics charts how your organisation has grown over the last three months:

• Users: the number of people with access to the organisation's projects, shown alongside Active users, meaning those who used DeveloperHub in the last 30 days.

• Projects: the number of projects in the organisation.

The charts are built from weekly snapshots, so a change you make today appears in the next snapshot rather than straight away.

Custom CSS

Organisation Settings → Custom CSS holds one stylesheet that can be shared by every project in the organisation. Only the organisation owner can edit it. Click Save changes to apply, or Discard to revert.

Projects do not inherit this stylesheet automatically. To opt a project in, open Project Settings → Customisation and turn on Use organisation CSS.

Where a project opts in, the organisation stylesheet is applied first and the project's own Custom CSS after it, so a project rule wins over an organisation rule of equal specificity. It applies to the published docs and to the editor.

SSO status

Organisation Settings → SSO status shows a read-only summary of your SSO configuration:

• SSO status: whether an SSO provider is set up for the organisation.

• Enforce SSO login: whether users must sign in through the provider.

• Default access to all projects: whether new editors are added to every project by default.

To change any of these, contact us.

Related

• Collaboration for project-level teammates and user roles.

• Editor Single Sign-On (SSO) for signing your team in through your identity provider.