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

# Guest Profiles

> View, edit, and manage guest profiles in ABRA

# Guest Profiles

<Info>
  Guest profiles are the heart of ABRA, storing everything you need to personalize each guest's experience.
</Info>

## Finding a Guest

<Steps>
  <Step title="Go to the Guests page">
    Navigate to **Guests** from the main menu to see your full guest list.
  </Step>

  <Step title="Search for a guest">
    Use the search bar to find guests by name, phone number, email, birthday, or anniversary date.
  </Step>

  <Step title="Open the profile">
    Click on the guest's name to open their full profile.
  </Step>
</Steps>

<Tip>
  You can search by date in MM/DD/YYYY format to find guests with birthdays or anniversaries on a specific date.
</Tip>

## Understanding the Profile Layout

When you open a guest profile, you will see several key sections:

<CardGroup cols={2}>
  <Card title="Bio Section" icon="user">
    Profile photo, name, VIP status, and contact information at the top
  </Card>

  <Card title="Stats Cards" icon="chart-simple">
    Quick counts for Notes, Hurdles, and Wow Moments
  </Card>

  <Card title="Preferences" icon="sliders">
    Guest preferences and allergies
  </Card>

  <Card title="Stay History" icon="calendar">
    All current and past reservations
  </Card>
</CardGroup>

### Guest Information Fields

The profile displays these details when available:

* **Birthday** - Date of birth
* **Anniversary** - Wedding or other anniversary date
* **Gender** - Guest's gender preference
* **Previous Stays** - Number of completed stays
* **Occupation** - Professional role
* **Address** - Street, city, state, country, and ZIP
* **Phone** - Contact number
* **Email** - Email address
* **VIP Reason** - Why the guest has VIP status (if applicable)

## Editing a Profile

<Steps>
  <Step title="Open the actions menu">
    Click the three-dot menu button in the top-right corner of the bio section.
  </Step>

  <Step title="Select Edit Guest Info">
    This opens a form with all editable fields.
  </Step>

  <Step title="Update the information">
    Edit any of the following:

    * Salutation (Dr., Mr., Miss, Mrs., Prof.)
    * First name and last name
    * Nickname
    * Email and phone number
    * Occupation and gender
    * Birthday and anniversary dates
    * Full address
    * VIP reason (if VIP is enabled)
  </Step>

  <Step title="Save your changes">
    Click **Submit** to save the updated profile.
  </Step>
</Steps>

<Note>
  If no guest information has been added yet, you will see an "Add Information" button instead of the edit pencil icon.
</Note>

## Managing Profile Photos

<Tabs>
  <Tab title="Add a Photo">
    1. Click on the profile photo area
    2. Select an image file from your computer
    3. Crop the image as needed
    4. The photo is saved automatically
  </Tab>

  <Tab title="Remove a Photo">
    1. Click the actions menu (three dots)
    2. Select the option to remove the photo
    3. Confirm the removal
  </Tab>
</Tabs>

Supported image formats: JPEG, PNG, GIF, BMP, WebP, and ICO.

## Working with VIP Status

VIP guests receive special visual treatment in ABRA with a golden halo effect around their profile card.

<Steps>
  <Step title="Toggle VIP status">
    Click the actions menu and select **Toggle VIP Status**.
  </Step>

  <Step title="Enter a reason">
    When enabling VIP, you must provide a reason (e.g., "Frequent guest," "Celebrity," "Wedding party").
  </Step>

  <Step title="Save">
    Click **Submit** to apply the VIP status.
  </Step>
</Steps>

<Warning>
  VIP status is visible to all staff. Only mark guests as VIP when appropriate for your property's policies.
</Warning>

## Viewing Stay History

The **Stay History** section shows all reservations for the guest, organized chronologically with the most recent at the top.

Each reservation displays:

* **Status badge** - In-House, Arrivals, Upcoming, Departures, or Past
* **Date range** - Check-in and check-out dates with number of nights
* **Room assignment** - Room number(s) for the stay
* **Accompanying guests** - Other guests traveling in the party
* **Total cost** - Reservation total (visible to Managers and Admins)

### Expanding Reservation Details

Click on any reservation to expand it and see:

* **Arrival time** - Expected time of arrival
* **Flight number** - If the guest provided flight information
* **Additional details** - Any notes about the stay
* **Celebrations** - Birthdays, anniversaries, or special occasions during the stay

<Tip>
  Current reservations are automatically expanded when you open the profile.
</Tip>

### Editing Stay Details

For current reservations, you can edit stay details by:

1. Right-clicking on the detail card (arrival time, flight, or additional details)
2. Selecting the edit option from the context menu
3. Making your changes and saving

## Quick Actions

From the guest profile, you can quickly:

<CardGroup cols={2}>
  <Card title="Add a Note" icon="plus">
    Click the **+** button to add preferences, nuggets, or celebrations
  </Card>

  <Card title="View Related Notes" icon="memo">
    Click the Notes stat card to see all notes mentioning this guest
  </Card>

  <Card title="Jump to Hurdles" icon="triangle-exclamation">
    Click the Hurdles stat card to scroll directly to open issues
  </Card>

  <Card title="See Wow Moments" icon="stars">
    Click the Wows stat card to view all special moments recorded
  </Card>
</CardGroup>

## Syncing with Your PMS

<Note>
  This feature is available for Managers, Hotel Admins, and Admins only.
</Note>

If your property uses an integrated PMS (Property Management System), you can manually sync reservation data:

1. Open a guest profile with a current reservation
2. Click the **sync** button (rotating arrows icon) in the Stay History header
3. Wait for the sync to complete
4. The page will refresh with updated information

## Merging Duplicate Profiles

<Info>
  Profile merging happens automatically when your PMS sends merge events. ABRA preserves all data from both profiles during a merge.
</Info>

When duplicate profiles are merged:

* All reservations are consolidated to the surviving profile
* Preferences, notes, celebrations, and hurdles are transferred
* Wow moments and touchpoints are preserved
* The duplicate profile is archived

If you notice duplicate guest profiles that have not been automatically merged, contact your system administrator or check your PMS for profile merge options.

## Related

<CardGroup cols={2}>
  <Card title="Preferences" icon="sliders" href="/guides/guests/preferences">
    Managing guest preferences and allergies
  </Card>

  <Card title="Living Profile Concept" icon="lightbulb" href="/concepts/living-profile">
    Understanding how profiles evolve over time
  </Card>
</CardGroup>