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

# Room Assignments

> Understanding how room assignments work in ABRA

# Room Assignments

<Info>
  Room assignments in ABRA are automatically synced from your Property Management System (PMS). This guide explains how to view room information and understand room-related data.
</Info>

## How Room Data Syncs

Room assignments flow from your PMS into ABRA automatically:

1. **Reservation created** - When a reservation is made in your PMS, ABRA receives the booking
2. **Room assigned** - When a room number is assigned in your PMS, ABRA updates the reservation
3. **Room changes** - If the guest moves rooms, ABRA tracks each assignment

<Note>
  Reservations can exist without a room assignment. This is common when rooms are assigned closer to check-in. ABRA will update automatically when the room is assigned in your PMS.
</Note>

## Viewing Room Information

### On the Reservations List

The Reservations page displays room numbers directly in the table:

<Steps>
  <Step title="Navigate to Reservations">
    Open the Reservations page from the main navigation
  </Step>

  <Step title="Find the Room Number column">
    The "Room Number" column shows the assigned room for each reservation
  </Step>

  <Step title="Filter by status">
    Use the status filter (Arrivals, In-House, Departures) to find specific reservations
  </Step>
</Steps>

### On the Guest Profile

When viewing a guest's Stay History:

* The **current room** displays with a bed icon next to each reservation
* For multi-room stays, all assigned rooms appear as a comma-separated list
* Expand any reservation to see additional stay details

## Room Types

Room types are categories configured by your property (e.g., "King Suite", "Double Queen"). ABRA receives room type information from your PMS and uses it to organize rooms.

<Tip>
  Room types help ABRA filter which reservations to display. If you notice missing reservations, check with your ABRA administrator to ensure the room type is configured.
</Tip>

## Multi-Room Stays

ABRA supports guests who occupy multiple rooms during a single stay:

| Scenario                           | How ABRA Handles It                                   |
| ---------------------------------- | ----------------------------------------------------- |
| Guest changes rooms mid-stay       | Each room assignment is tracked separately with dates |
| Guest books multiple rooms at once | All rooms display together on the reservation         |
| Family suite across rooms          | Rooms appear as a combined list (e.g., "101, 102")    |

### Viewing Multi-Room Details

On the guest profile, the room display shows:

* **Single room**: "Room 101"
* **Multiple rooms**: "Room 101, Room 102"
* **No room yet**: "No room assigned"

## Manual Sync from PMS

If room information appears outdated, managers can trigger a manual sync:

<Steps>
  <Step title="Open the guest profile">
    Navigate to the guest's Stay History section
  </Step>

  <Step title="Click the sync button">
    Click the refresh icon near the Stay History header
  </Step>

  <Step title="Wait for update">
    ABRA will fetch the latest data from your PMS
  </Step>
</Steps>

<Warning>
  Manual sync is available to Managers, Hotel Admins, and Admins only. If you need updated room information and don't see the sync button, contact your manager.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Room number shows as 'No room assigned'">
    This means the room hasn't been assigned yet in your PMS. Once assigned there, ABRA will update automatically during the next sync.
  </Accordion>

  <Accordion title="Room number doesn't match the PMS">
    Try using the manual sync button. If the issue persists, the reservation may need to be updated in your PMS first.
  </Accordion>

  <Accordion title="Guest changed rooms but old room still shows">
    Room changes should sync automatically. Use manual sync to force an update, or wait for the next scheduled sync cycle.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Reservations Overview" icon="calendar" href="/guides/reservations/overview">
    Understanding reservation statuses
  </Card>

  <Card title="Reservation Notes" icon="note-sticky" href="/guides/reservations/notes">
    Working with reservation notes
  </Card>
</CardGroup>
