Organization settings

Organization admins access Settings to configure organization-wide policies, manage integrations, and control member access. These settings affect your entire organization and are only accessible to users with the organization admin role.

​

Access organization settings

---

​

General

Configure your organization’s basic information and access controls. Organization branding:

• Organization name: Display name shown throughout Ravenna
• Organization logo: Custom logo appears in navigation and login screens

Access controls:

• Direct login URL: Unique URL for your team to access Ravenna directly (e.g., app.ravenna.ai/login?organization=your-org)
• Workspace creation: Restrict who can create new workspaces (admins only or all organization members)
• Guest visibility: Control whether guest members can see and access your organization. When disabled (default), guests cannot see your organization in their workspace switcher or log in. Enable this setting to allow guest users to access your organization and use the requester portal.
• Slack Direct Message Routing: Automatically route Slack direct messages to the right workspace based on the question. When enabled, the first message a user sends to the Ravenna app in Slack is classified by an AI agent and directed to the workspace whose Agent is the best fit. When disabled, users pick a workspace manually before chatting. Only workspaces with Show in DMs enabled in Workspace Settings > Slack are eligible for routing.

---

​

Portal

Brand the requester portal that end users and guests see. Changes save automatically as you edit. Branding options:

• Primary color: Accent color applied across the portal
• Welcome message: Greeting headline shown on the portal home (up to 120 characters)
• Organization logo: Show your logo in the portal header
• Gradient banner: Show or hide the colored banner behind the greeting
• Cover image: Upload a wide header image
• Suggested questions: Up to six starting prompts for the portal chat, each with an icon, color, label, and optional custom agent prompt

Which workspaces appear in the portal is controlled per workspace with the Customer Portal toggle in workspace settings.

---

​

Notification policies

Set default notification preferences that apply to all users and new members in your organization. Individual users can override these defaults with their own preferences. Policy configuration:

• Default Slack notifications: Enable or disable Slack notifications by event type (assignments, messages, status updates, SLA alerts)
• Default email notifications: Enable or disable email notifications by event type (assignments, approvals, messages, status updates, SLA alerts)
• New user defaults: These settings automatically apply to new organization members

User customization: Users can customize their own notification preferences in their personal settings. Organization policies serve as the starting point but don’t prevent users from adjusting their preferences.

---

​

Integrations

Connect and manage third-party integrations for your organization. Browsing integrations:

• Use the category sidebar to filter integrations by type (Chat, Ticketing, HRIS, Incident Management, and more)
• Each integration tile shows its connection status

Integration management:

• View connected integrations and their status
• Configure integration settings and permissions
• Add or remove integration connections

Connection status badges: Each connected integration tile displays a status badge that reflects the most recent health check:

---

​

SSO

Configure Single Sign-On authentication for your organization.

• Connect your identity provider (Okta, Azure AD, Google Workspace, SAML, OIDC)
• Manage SSO connections and domain settings
• Enforce SSO-only authentication

---

​

Email

Manage custom email domains for outbound messages sent from Ravenna. By default, replies and notifications are sent from mail.ravenna.ai. Configuring a custom domain lets outbound mail appear to come from a domain you control (for example, support@yourcompany.com), which improves brand consistency and deliverability. Domain management:

• Add the domain you want to send from
• Follow the DNS instructions shown in settings to verify ownership and authorize sending
• Once verified, the domain becomes available for channels to use as their outbound sender

---

​

Vault

Store encrypted credentials for use in workflows and integrations. Vault credentials are encrypted at rest and can only be managed by organization admins. Credential management:

• Create credentials with a name and secret value
• Values are encrypted immediately and cannot be viewed after creation
• A hint (first and last characters) helps identify credentials
• Edit credential names or rotate values
• Delete credentials that are no longer needed

---

​

Applications

View and manage your application catalog, including both manually created applications and those synced from integrated identity providers. Application types:

• Manual applications: Applications you create and manage directly in Ravenna
• Synced applications: Applications automatically imported from Okta, Google Workspace, or other supported integrations

Application management:

• Define access levels for each application
• Configure approval workflows for access requests
• Set application owners and details
• Map access levels to identity provider groups

---

​

Workspaces

View and manage all workspaces within your organization, including both public and private workspaces. Workspace overview:

• See all workspaces regardless of your membership status
• View workspace privacy settings (public or private)
• Access workspace settings and configuration
• Navigate directly to any workspace

Workspace management: As an organization admin, you can:

• Create new workspaces
• Configure workspace settings
• Manage workspace members and permissions
• Archive or delete workspaces

---

​

Members

Manage organization membership, roles, and permissions for all users in your organization. Member management:

• View all organization members (admins, members, guests)
• Invite new members to your organization
• Modify member roles and permissions
• Remove members from the organization
• Access individual member profiles to view workspace memberships

Member profiles: Click any member to view their profile, which includes:

• Organization role and permissions
• Workspace memberships
• Contact information
• Recent activity

---

​

Admin audit log

Track administrative actions across your organization with a searchable audit log. The audit log records changes made by admins to agents, integrations, knowledge bases, and forms. Viewing audit events:

• Navigate to Settings > Admin Audit Log in your organization settings
• Browse events in the table view with timestamp, event type, actor, and resource columns
• Click any event to expand a detail panel with full context, including before and after values

Filtering and searching:

• Search events by keyword
• Filter by event type, actor, resource, or date range
• Group events by actor, event type, resource type, or date for pattern analysis

Exporting:

• Export filtered audit events to CSV for compliance reporting or external analysis