What this page is for
This page holds everything CityLights knows about one property: names, address, capacity, default check-in and check-out times, currency, timezone and house rules. Other modules add their own panels here, for example connected channels.
Who can use it
- View properties opens the page. Without Edit properties the form is read-only.
- Add properties is needed to create a property.
- Offboard properties and Delete unused properties control the buttons on the right.
How to add a property
- Select Add property on the Properties page.
- Enter at least the Name.
- Select Save. You can fill in the rest later.
How to offboard or delete a property
- Offboard this property keeps all its history but removes it from automations and from the licence unit count.
- Delete property works only when no bookings, expenses or other records use it. The message lists what still uses it.
Fields and columns
| Field | What it means | Rules |
|---|---|---|
| Name | Your internal name | Required, up to 150 characters. |
| Listing title | The name guests see on receipts and messages | Optional. The name is used when empty. |
| Code | A short code for reports and imports | Optional, unique in your organisation. |
| Status | Active, Onboarding, Inactive (closed), Offboarded | See below. |
| Group | Building or area | From Property groups. |
| Photos | Pictures of the unit. You can pick several at once. | JPEG, PNG or WebP, up to 10 MB each, 20 per upload. |
| Company cost centre | Not rentable; holds company-wide costs | Used by expense and profit reports. |
| Address | Street, town, region, postcode, country code | Country is two letters, e.g. GB. |
| Check-in from, Check-out by | Default times for guest messages | Optional, 24-hour time. |
| Maximum guests, Bedrooms, Beds | Capacity | Whole numbers. |
| House rules | Rules for this property | Empty means your organisation's house rules. |
| Currency | The property's currency | Three letters, e.g. EUR. Empty means your base currency. |
| Timezone | For properties in another timezone | Empty means your organisation's timezone. |
| Internal notes | Notes for staff only | Never shown to guests. |
| Connected channels | Channel ids filled in by channel connectors | Read-only. |
| History | Every change to this property | Select an entry to see before and after values. |
How to manage photos
- Save the property, then scroll to Photos.
- Choose photos under Add photos and select Upload. The first photo becomes the Main photo.
- Select Make main on another photo to use it instead. The main photo appears in the property list, the bookings list, the calendars, the front desk board and your booking website.
- Change a Caption or Order (lower numbers first) and select Save, or Delete a photo. Deleting the main photo makes the next one main.
Photos are cleaned (location data removed) and smaller copies are made in the background for fast pages.
Statuses and automation
- Active and Onboarding: included in automations.
- Inactive (closed): kept, but skipped by automations (for example no pre check-in messages).
- Offboarded: kept for history; not counted towards the licence unit limit.
- Every change is recorded in the history.
Settings that change this page
- Your organisation's base currency and timezone are in Settings.
FAQs
Why does the guest see a different name? Guests see the Listing title when one is set.
Can I change the currency later? Yes, but existing bookings keep the currency they were made in.
Troubleshooting
| Problem | What to do |
|---|---|
| "The code has already been taken." | Another property uses that code. Choose another. |
| "... is still used by: ..." | Offboard the property instead of deleting it. |
| "Your licence covers N units" | Offboard a property or upgrade your licence. |