Creating an organization

Configuration

Navigate to Organizations in the Admin Console. You will find organizations listed by identity store if any were created. Switch between identity stores using the identity store selector to view and create organizations in a particular store.

👍

You can use the + Create organization button to make a new organization. Organization settings will appear on a new screen.

Settings

You can configure mandatory and optional organization settings.

Mandatory

• Name The organization will go by this name in the customer experience and in the Admin Console. This field supports any letter and number in Unicode and the special characters ., :, /, _, (, ), [, ], |, &, ', ", ?, !, @, +, *, °.
• Routes Here you provide the route(s) to your organization. You can create multiple routes if needed.

📘

If not routed automatically Login hint support or Identifier-based routing, customers will need to type in the route identifier of their organization on the organizational selector screen.

Requirements

⚠️ Organizational route identifiers have strict requirements.

✅

Tip

It's best to choose a descriptive but easy-to-remember name for the route identifier.

Optional

Basic settings

• Description Add a description to your organization that administrators can view for more context about the organization.
• Parent organization Add a parent organization to place the current organization into your organizational structure.

📘

Parent organizations allow you to build a hierarchy of organizations, separate organizaitonal branches in your structure, and to control access to suborganizations.

Branding

Organization settings allow you to add essential styling to the organization's customer experience.

📘

The branding you provide here applies to the organization’s login, registration, and self-service unless there's a branding policy override in an application configuration.

• Favicon URL You can set a custom favicon for your organization that you host from an external resource.
• Logo URL You can set a custom logo for your organization that you host from an external resource.

🚧

Content-type header format

Logo and favicon display has a safeguard in place that makes sure the browser only accepts image responses from the source URLs and not some malicious JS code. In order to display your images, the content-type header of your service that hosts the brand logo and favicon must contain at least one of the following formats:

• image/png
• image/jpg
• image/svg+xml

• Primary color You can define the primary brand color of the organization. The primary color applies to the main UI components of the customer experience, such as the action buttons, target select, input field focus, etc.
• Background color You can define the background color of the organization's experience.

Self-service

• Self-service registration You can allow or disable self-service registration into this organization.
• Child organization registration You can allow or disable child organization registration for this organization. Users with the right permission can register a new organization under the current one.

👍

Once you've added your configurations, you can click Save to finish creating the organization.