> ## 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
    * **No Delegate**: Remove delegate assignment
  </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>

### Primary teamspace

Set a default <Tooltip headline="Workspace" tip="Separate environment for different teams or departments" cta="Learn about workspaces" href="/documentation/platform/workspaces/overview">workspace</Tooltip> to streamline ticket creation and navigation. Your primary teamspace determines the default ticket creation location when multiple workspace options are available.

<Info>
  Selecting a primary teamspace helps Ravenna optimize your experience by prioritizing content from your main workspace.
</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 theme and color scheme preferences.

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

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

<Info>
  Theme and color scheme 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>