My settings

Configure your personal Ravenna user settings including profile, notification preferences, theme appearance, and connected app integrations.

Configure your personal Ravenna settings. Access user settings through the settings menu to customize your profile, preferences, appearance, and app integrations.

1. Navigate to user settings

   Click your profile icon in the top right corner and select Settings.

2. Select a settings category

   Select from Profile, Preferences, Appearance, or Connected Apps in the left sidebar.

3. Make your changes

   Update your settings and save. Most changes apply immediately.

Organization admins can configure some user settings on behalf of members through the member management interface.

---

Profile

Manage your profile information including name and profile image.

Profile fields

Profile image

Upload a profile picture to personalize your account. Your profile image appears throughout Ravenna in ticket assignments, comments, and user mentions.

Requirements:

• Maximum file size: 1 MB
• Supported formats: PNG, JPG, JPEG, WebP
• Maximum dimensions: 512x512 pixels
• Image cropper available to adjust framing

1. Upload image

   Click Upload profile image and select a file from your device.

2. Crop image

   Use the crop tool to adjust the framing and select the best portion of your image.

3. Save

   Click Save to update your profile image across Ravenna.

Name

Your first and last name display throughout Ravenna in tickets, assignments, and team directories.

Fields:

• First Name (required): Your given name
• Last Name (required): Your family name

Name changes reflect immediately across all tickets, assignments, and mentions throughout the platform.

---

Preferences

Configure operational preferences including delegate assignment and default workspace.

Delegate

Assign a delegate to handle tickets when you’re away. Delegates receive ticket assignments and approvals on your behalf, ensuring continuity when you’re unavailable.

1. Navigate to preferences

   Go to Settings → Preferences.

2. Select delegate option

   In the User Delegate section, select your delegate from the dropdown:

   • Manager: Automatically assigns your direct manager (requires Okta integration)
   • Specific user: Select any organization member as your delegate
   • No Delegate: Remove delegate assignment
3. Save changes

   Your delegate assignment saves automatically.

Manager delegation

When you select “Manager” as your delegate, Ravenna automatically resolves your direct manager from your Okta integration. This option appears only when your organization has configured Okta integration.

Benefits:

• Automatic resolution based on organizational hierarchy
• No manual updates needed when reporting structure changes
• Maintains proper escalation paths

User delegation

Select a specific organization member as your delegate. You can select any admin or member from your organization to handle tickets during your absence.

When to use:

• No Okta integration configured
• Prefer specific colleague over manager
• Cross-functional delegation needs

How delegation works

When a delegate is assigned:

• Ticket assignments directed to you route to your delegate
• Approval requests forward to your delegate
• Your delegate receives notifications for tickets you would normally handle
• Delegation persists until you change or remove it

Delegation doesn’t transfer existing tickets. It only affects new assignments and approvals while the delegation is active.

Out of office

Control your availability status to automatically redirect ticket assignments and approvals to your delegate when you’re unavailable.

1. Navigate to preferences

   Go to Settings → Preferences.

2. Select OOO status source

   Select how your out of office status is determined:

   • Manual: Manually toggle your OOO status on and off
   • Slack Status: Automatically sync from your Slack status
3. Configure your status

   • Manual mode: Toggle the Out of Office switch to mark yourself as unavailable
   • Slack mode: Set a Slack status that indicates you’re away (for example, “OOO until Friday”, “On PTO”, “Vacationing 🏖️”) to automatically mark yourself as unavailable

Manual OOO mode

Manually control your out of office status with a simple toggle. Use this mode when you want direct control over your availability or when you don’t use Slack.

How it works:

• Toggle Out of Office on when you’re unavailable
• Toggle back to Available when you return
• Status persists until you manually change it
• Requires delegate assignment for ticket redirection

Manual mode gives you precise control over when tickets are redirected to your delegate, independent of any external systems.

Slack status sync

Automatically sync your out of office status from Slack. When enabled, Ravenna monitors your Slack status and updates your availability in real-time.

How status is detected:

Ravenna uses AI to interpret your Slack status text, so you don’t need to use a specific phrase. Common examples that mark you as out of office include:

• Vacation and time off: “Vacationing”, “On vacation”, “Holiday”, “Beach mode 🏖️”
• Sick leave: “Out sick”, “Sick day”, “Under the weather”
• Out of office: “OOO”, “OOO until Friday”, “Out of office”, “Away”
• Paid time off: “PTO”, “On PTO”, “PTO until 6/15”
• Extended leave: “On leave”, “Parental leave”, “Sabbatical”, “Bereavement”
• Day off: “Off today”, “Taking the day off”, “Personal day”

You stay marked as available for focus and work-mode statuses like “WFH”, “Heads down”, “In a meeting”, “On call”, “BRB”, or “Lunch”. You also stay available for statuses that reference someone else’s absence (for example, “Covering for Alex who is OOO”) or a future or past absence (for example, “OOO next week” or “Back from PTO”).

How sync works:

• Status changes are detected in real-time via Slack events
• When your Slack status indicates you’re away, you’re automatically marked as unavailable
• When your Slack status clears or changes to something else, you’re marked as available
• Supports status expiration - automatically becomes available when Slack status expires
• Works across multiple connected Slack workspaces - if you’re OOO in any workspace, you’re marked as OOO

Slack status sync requires you to have a delegate configured. Without a delegate, status changes won’t redirect tickets.

Microsoft Teams presence sync is not available in the current beta. Use manual OOO mode if you primarily work in Microsoft Teams. See the Microsoft Teams integration overview.

Ticket redirection

When you’re marked as out of office (either manually or via Slack sync), new ticket assignments and approval requests automatically redirect to your delegate.

What gets redirected:

• New ticket assignments
• Approval requests
• Notifications for redirected items

What doesn’t change:

• Existing ticket assignments remain with you
• Historical ticket records
• Your role in past tickets

Delegation chains: If your delegate is also out of office, Ravenna follows the delegation chain to find an available person. For example, if you delegate to Person B who delegates to Person C, assignments will go to Person C if Person B is also unavailable.

Delegation chains prevent tickets from getting stuck when multiple team members are unavailable simultaneously.

Primary teamspace

Set a default workspace to streamline ticket creation and navigation. Your primary teamspace determines the default ticket creation location when multiple workspace options are available.

Selecting a primary teamspace helps Ravenna optimize your experience by prioritizing content from your main workspace.

---

Notifications

Control when and how you receive updates about tickets, assignments, and team activity. Configure delivery preferences for Slack and email independently.

Learn more about notification settings

---

Appearance

Customize how Ravenna looks with theme and color scheme preferences.

Theme

Select between light, dark, or system-based theme preferences:

Light

Light theme uses bright backgrounds optimized for well-lit environments. Best for daytime use or bright office settings.

Dark

Dark theme uses dark backgrounds that reduce eye strain in low-light conditions. Ideal for evening work or dim environments.

System

System theme automatically matches your operating system’s theme preference. Switches between light and dark based on your OS settings.

Color scheme

Select your preferred color palette for the Ravenna interface. Color schemes affect accent colors, buttons, and interactive elements throughout the platform.

Available schemes:

• Almond (default): Warm, neutral tones
• Crimson: Bold red accents
• Emerald: Fresh green tones
• Ocean: Cool blue palette
• Sunset: Orange and amber hues

Theme and color scheme changes apply immediately without requiring a page refresh.

---

Connected apps

Link external applications to your Ravenna account for enhanced integration capabilities.

Slack

Connect your Slack identity so messages sent from Ravenna appear as you in Slack instead of the Ravenna bot.

Connecting Slack profiles

After interacting with Ravenna in Slack, your Slack profiles become available to connect in user settings.

1. Interact with Ravenna in Slack

   Create or comment on a ticket through the Ravenna Slack integration. This registers your Slack profile.

2. Navigate to Connected Apps

   Go to Settings → Connected Apps.

3. Connect profile

   Click Connect next to your Slack workspace to authorize the connection.

Once connected, replies you send from Ravenna will appear as your Slack user in Slack threads rather than as the Ravenna bot.

Managing multiple Slack workspaces

If your organization uses multiple Slack workspaces, you can connect each workspace separately. Each connection requires individual authorization.

Multi-workspace support:

• Connect to multiple Slack workspaces
• Each workspace requires separate authorization
• Disconnect individual workspaces without affecting others

Disconnecting Slack

Disconnect your Slack identity to revoke Ravenna’s ability to post as you in Slack.

1. Navigate to Connected Apps

   Go to Settings → Connected Apps.

2. Find your Slack workspace

   Locate the connected workspace you want to disconnect.

3. Disconnect

   Click Disconnect and confirm your choice.

After disconnecting, messages sent from Ravenna will appear as the Ravenna bot instead of your Slack user until you reconnect.

Learn more about Slack integration

---

Admin management

Organization admins can configure some user settings on behalf of members through the member management interface.

1. Navigate to organization settings

   Go to Settings → Organization → Members.

2. Select member

   Click a member’s row to open their profile drawer.

3. Edit member details

   Click Edit in the Ravenna section to modify delegate assignment and other settings.

4. Save changes

   Changes apply immediately to the user’s preferences.

Learn more about managing organization members