> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Steps>
  <Step title="Navigate to user settings">
    Click your profile icon in the top right corner and select **Settings**.
  </Step>

  <Step title="Select a settings category">
    Select from Profile, Preferences, Appearance, or Connected Apps in the left sidebar.
  </Step>

  <Step title="Make your changes">
    Update your settings and save. Most changes apply immediately.
  </Step>
</Steps>

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

***

## Profile

Manage your profile information including name and profile image.

### Profile fields

<AccordionGroup>
  <Accordion title="Profile image" icon="image" defaultOpen>
    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

    <Steps>
      <Step title="Upload image">
        Click **Upload profile image** and select a file from your device.
      </Step>

      <Step title="Crop image">
        Use the crop tool to adjust the framing and select the best portion of your image.
      </Step>

      <Step title="Save">
        Click **Save** to update your profile image across Ravenna.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Name" icon="user">
    Your first and last name display throughout Ravenna in <Tooltip headline="Tickets" tip="Support requests and work items" cta="Learn about tickets" href="/documentation/tickets/channels">tickets</Tooltip>, assignments, and team directories.

    **Fields:**

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

    <Info>
      Name changes reflect immediately across all tickets, assignments, and mentions throughout the platform.
    </Info>
  </Accordion>
</AccordionGroup>

***

## 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.

<Steps>
  <Step title="Navigate to preferences">
    Go to **Settings → Preferences**.
  </Step>

  <Step title="Select delegate option">
    In the User Delegate section, select your delegate from the dropdown:

    * **Manager**: Automatically assigns your direct manager (requires <Tooltip headline="Okta integration" tip="Identity provider integration for user management" cta="Learn about Okta setup" href="/integrations/okta/overview">Okta integration</Tooltip>)
    * **Specific user**: Select any organization member as your delegate

    To remove your delegate, click the clear button on the select.
  </Step>

  <Step title="Save changes">
    Your delegate assignment saves automatically.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Manager delegation" icon="user-round-cog">
    When you select "Manager" as your delegate, Ravenna automatically resolves your direct manager from your <Tooltip headline="Okta integration" tip="Identity provider integration for user management" cta="Learn about Okta setup" href="/integrations/okta/overview">Okta integration</Tooltip>. 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
  </Accordion>

  <Accordion title="User delegation" icon="users">
    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
  </Accordion>

  <Accordion title="How delegation works" icon="arrow-right-left">
    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

    <Warning>
      Delegation doesn't transfer existing tickets. It only affects new assignments and approvals while the delegation is active.
    </Warning>
  </Accordion>
</AccordionGroup>

### Out of office

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

<Steps>
  <Step title="Navigate to preferences">
    Go to **Settings → Preferences**.
  </Step>

  <Step title="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
  </Step>

  <Step title="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
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Manual OOO mode" icon="toggle-left" defaultOpen>
    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

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

  <Accordion title="Slack status sync" icon="slack">
    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

    <Warning>
      Slack status sync requires you to have a delegate configured. Without a delegate, status changes won't redirect tickets.
    </Warning>

    <Note>
      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](/integrations/microsoft-teams/overview).
    </Note>
  </Accordion>

  <Accordion title="Ticket redirection" icon="arrow-right-left">
    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.

    <Info>
      Delegation chains prevent tickets from getting stuck when multiple team members are unavailable simultaneously.
    </Info>
  </Accordion>
</AccordionGroup>

### Rapid ticket creation

Skip the ticket creation modal and instantly create tickets from Slack <Tooltip headline="Message shortcuts" tip="Right-click any Slack message to create a ticket from it" cta="Learn about creating tickets" href="/integrations/slack/creating-tickets">message shortcuts</Tooltip>. When enabled, the message you shortcut becomes the first message on the ticket, and Ravenna auto-generates a title and description from the conversation.

The workspace you pick here is your **primary workspace** (sometimes called your primary teamspace). It only affects Slack rapid ticket creation. It does not change which workspace loads first in the Ravenna UI or override workspace defaults for other users.

<Steps>
  <Step title="Navigate to preferences">
    Go to **Settings → Preferences**.
  </Step>

  <Step title="Select a workspace">
    In the Rapid Ticket Creation section, open the searchable select on the Workspace row and choose the <Tooltip headline="Workspace" tip="Separate environment for different teams or departments" cta="Learn about workspaces" href="/documentation/platform/workspaces/overview">workspace</Tooltip> where rapid-created tickets should land. Your choice saves immediately. It enables the feature and sets your primary workspace.
  </Step>

  <Step title="Disable (optional)">
    To turn off rapid creation, click the clear button on the Workspace select. The change saves immediately, and Slack shortcuts show the full ticket creation form again.
  </Step>
</Steps>

<Info>
  Each member picks their own primary workspace. There is no organization-wide default that admins can preset on behalf of members.
</Info>

<Warning>
  The selected workspace must have a default channel configured. If no default channel exists, Ravenna falls back to the standard ticket creation modal.
</Warning>

<Callout icon="link" color="#6B7280">
  Learn more about [creating tickets from Slack](/integrations/slack/creating-tickets)
</Callout>

### Working hours

Pick the [business schedule](/documentation/platform/workspaces/settings#business-schedules) that describes when you are available. Ravenna uses this preference to defer automation-driven pings to you until they land inside your own working windows, rather than a shared workspace schedule.

Today it powers the **Assignee Hours** and **Approver Hours** options on [reminder policies](/documentation/tickets/reminders#business-hours-and-weekends). When an admin sets a policy to one of those options, Ravenna sends each reminder using the assignee's or pending approver's Working Hours preference. Reminders on a policy set to **No schedule** or a specific workspace schedule are not affected.

<Steps>
  <Step title="Navigate to preferences">
    Go to **Settings → Preferences**.
  </Step>

  <Step title="Pick a schedule">
    In the Working Hours section, open the **Business schedule** picker. Schedules are grouped by workspace, so a schedule with the same name in two workspaces stays distinguishable. You can pick a schedule from any workspace you belong to.
  </Step>

  <Step title="Clear the schedule (optional)">
    Click the clear button on the **Business schedule** picker to opt out. Reminders on policies set to **Assignee Hours** or **Approver Hours** then fall back to a plain wall-clock interval for you.
  </Step>
</Steps>

<Info>
  Your Working Hours preference is stored on your organization membership, not on your user account. If you belong to more than one organization, each has its own preference.
</Info>

***

## Notifications

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

<Callout icon="link" color="#6B7280">
  Learn more about [notification settings](/documentation/platform/notifications)
</Callout>

***

## Appearance

Customize how Ravenna looks with your theme preference.

### Theme

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

<Tabs>
  <Tab title="Light">
    Light theme uses bright backgrounds optimized for well-lit environments. Best for daytime use or bright office settings.
  </Tab>

  <Tab title="Dark">
    Dark theme uses dark backgrounds that reduce eye strain in low-light conditions. Ideal for evening work or dim environments.
  </Tab>

  <Tab title="System">
    System theme automatically matches your operating system's theme preference. Switches between light and dark based on your OS settings.
  </Tab>
</Tabs>

<Info>
  Theme changes apply immediately without requiring a page refresh.
</Info>

***

## 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.

<AccordionGroup>
  <Accordion title="Connecting Slack profiles" icon="slack" defaultOpen>
    After interacting with Ravenna in Slack, your Slack profiles become available to connect in user settings.

    <Steps>
      <Step title="Interact with Ravenna in Slack">
        Create or comment on a ticket through the Ravenna Slack integration. This registers your Slack profile.
      </Step>

      <Step title="Navigate to Connected Apps">
        Go to **Settings → Connected Apps**.
      </Step>

      <Step title="Connect profile">
        Click **Connect** next to your Slack workspace to authorize the connection.
      </Step>
    </Steps>

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

  <Accordion title="Managing multiple Slack workspaces" icon="building-2">
    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
  </Accordion>

  <Accordion title="Disconnecting Slack" icon="unplug">
    Disconnect your Slack identity to revoke Ravenna's ability to post as you in Slack.

    <Steps>
      <Step title="Navigate to Connected Apps">
        Go to **Settings → Connected Apps**.
      </Step>

      <Step title="Find your Slack workspace">
        Locate the connected workspace you want to disconnect.
      </Step>

      <Step title="Disconnect">
        Click **Disconnect** and confirm your choice.
      </Step>
    </Steps>

    <Warning>
      After disconnecting, messages sent from Ravenna will appear as the Ravenna bot instead of your Slack user until you reconnect.
    </Warning>
  </Accordion>
</AccordionGroup>

<Callout icon="link" color="#6B7280">
  Learn more about [Slack integration](/integrations/slack/overview)
</Callout>

***

## Admin management

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

<Steps>
  <Step title="Navigate to organization settings">
    Go to **Settings → Organization → Members**.
  </Step>

  <Step title="Select member">
    Click a member's row to open their profile drawer.
  </Step>

  <Step title="Edit member details">
    Click **Edit** in the Ravenna section to modify delegate assignment and other settings.
  </Step>

  <Step title="Save changes">
    Changes apply immediately to the user's preferences.
  </Step>
</Steps>

<Callout icon="link" color="#6B7280">
  Learn more about [managing organization members](/documentation/platform/organizations/overview#managing-organization-members)
</Callout>


## Related topics

- [Product Updates](/changelog/2026.md)
- [My Tickets tab](/integrations/microsoft-teams/my-tickets-tab.md)
- [Portal](/documentation/platform/portal.md)
- [Categories](/documentation/tickets/organize/categories.md)
- [Organization settings](/documentation/platform/organizations/settings.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.