| Purpose | Set up a tax that charges each guest a fixed amount, or a percentage, per night, with the amount chosen by the price of the night. |
| Best for | Property owners and admins whose local tax depends on the nightly price, such as the Tokyo accommodation tax. |
| Use this when | Guests in cheaper rooms pay less or nothing, and guests in pricier rooms pay more, and you want Cloudbeds PMS to charge the correct amount on every reservation. |
| Requirements | Owner or admin access to Cloudbeds PMS with the Taxes and Fees role permission enabled. The tax brackets (tiers) that apply to your property, from your tax office or accountant. |
| Expected result | Each night of a reservation is charged the tier amount that matches its price, posted to the folio as one tax line per night. |
| Important limit | Tiered taxes are always exclusive. Bookings from channels and OTAs may not carry the tiered amount yet. See Channels and OTAs. |
Introduction
Some local taxes charge each guest a set amount, or a percentage, that depends on how much the night costs. The Tokyo accommodation tax is one example: guests in cheaper rooms pay less or nothing, and guests in pricier rooms pay more.
Without tiers, you had to post one amount on every booking and then void or adjust it by hand when the price fell into a different bracket. With the Tiered per guest per night rule, Cloudbeds PMS charges the right tier for every night automatically.
Tiers, amounts, percentages, rounding, and date periods are all configurable, so the same rule works for other municipalities with different brackets.
The Tiered per guest per night rule is available on request while it rolls out. If you don't see it in the Rule list, contact Cloudbeds Support.
In this article
- Watch the walkthrough
- How the rule chooses the tier
- Set up a tiered tax
- Examples
- Example setup: Tokyo accommodation tax
- What you will see on reservations
- Channels and OTAs
- Limitations
- FAQs
Watch the walkthrough
Watch this short walkthrough of the Tiered per guest per night tax before you set it up, or follow the written steps below.
How the rule chooses the tier
Under Tier price varies, you choose how the price that picks the tier is measured. Choose the option your local rule follows.
| Per person | Per room | |
|---|---|---|
| Price that picks the tier | The room's nightly price divided by the adults and children staying. Infants are not counted. | The room's full nightly price, however many guests stay. |
| Percentage tiers (% of price) | Available | Not available |
| Child amount option | Available | Not available |
Example: A ¥24,000 room with 2 adults, and tiers of ¥100 from ¥10,000 and ¥200 from ¥15,000.
| Tier price varies | Price that picks the tier | Tax per guest | Tax per night |
|---|---|---|---|
| Per person | ¥12,000 per guest | ¥100 | ¥200 |
| Per room | ¥24,000 | ¥200 | ¥400 |
Set up a tiered tax
- Go to Account
> Settings
> Finance
> Taxes and Fees.
- Click + New tax or fee.
- Choose Tax, enter a Title (for example, Accommodation tax), and keep Exclusive selected. Tiered taxes are always exclusive.
- Under Rule, choose Tiered per guest per night.
- Under Tier price varies, choose Per person or Per room. See How the rule chooses the tier.
- Under Price includes, tick Taxes and/or Fees if those should count toward the price that picks the tier. Leave them unticked to use the room price alone.
- Optional: under Advanced > Round the price down to, enter a step such as 100. The price is rounded down to that step before the tier is picked and before any percentage is calculated.
- Fill in the tier table. The first row always starts at 0. Click Add tier for each bracket, then enter:
- Price from: the lowest nightly price for that tier. The tier applies up to the next tier's starting price.
- Per adult: the amount each adult pays per night.
- Per child (optional): the amount each child pays per night.
- % of price (Per person only): charge each guest this percentage of their price instead of a fixed amount. Leave it empty to charge the amounts.
- Choose the accommodations and the Date range the tax applies to. Use a separate date period when the rules change on a set date.
- Click Save. If the tax is applied to sources with future reservations, you are asked whether to recalculate them. See What you will see on reservations.
- Add the tax to your reservation sources so it is charged. See Step 2 - Apply the tax to reservation sources.
[PLACEHOLDER: Screenshot of the New tax or fee form with the Tiered per guest per night rule selected, showing Tier price varies, Price includes, and the tier table with at least two tiers.]
Hover over the question-mark icons in the form for a short explanation of each setting.
You're not done yet. A tax that is not added to the reservation source posts nothing. Complete the last step above before you expect it on reservations.
Examples
Expand the examples below to see how each setting changes the result.
Which fees count toward the tier
A room costs ¥14,000 per night, plus a ¥2,000 and a ¥500 nightly fee, with 1 adult. Tiers: ¥0 below ¥10,000, ¥100 from ¥10,000, and ¥200 from ¥15,000.
| Price includes | Price that picks the tier | Tax per night |
|---|---|---|
| All fees | ¥16,500 | ¥200 |
| No fees | ¥14,000 | ¥100 |
| Only the ¥2,000 fee | ¥16,000 | ¥200 |
| Only the ¥500 fee | ¥14,500 | ¥100 |
Fees left out of the price are still charged to the guest. They just don't count toward the tier.
Percentage tier with rounding
The tax is 3% from ¥13,000 and nothing below. The price is rounded down to ¥100, with 1 adult.
| Nightly price | After rounding | Tax per night |
|---|---|---|
| ¥13,550 | ¥13,500 | ¥405 |
| ¥13,050 | ¥13,000 | ¥390 |
| ¥12,999 | Below ¥13,000 | ¥0 (no tax line) |
A stay across a rule change
A three-night stay from 30 March to 2 April 2027 costs ¥18,000 per night, with 1 adult. Each night is charged under the date period it falls in.
- 30 and 31 March: ¥200 per night under the current tiers.
- 1 April: ¥540 (3% of ¥18,000) under the new date period.
Total tax: ¥940.
Example setup: Tokyo accommodation tax
Tokyo charges per person per night, on the price excluding consumption tax, and changes to a percentage on 1 April 2027. Create one tax with two date periods:
| Date period | Tiers (per person) | Settings |
|---|---|---|
| Until 31 March 2027 | ¥0 from ¥0; ¥100 from ¥10,000; ¥200 from ¥15,000 | Per person; Taxes unticked |
| From 1 April 2027 | ¥0 from ¥0; 3% from ¥13,000 | Per person; Taxes unticked; round down to ¥100 |
Add the 1 April 2027 period now for properties in Tokyo, so bookings already made for April 2027 onwards are charged correctly. Children are taxed like adults in Tokyo, so enter the same amount under Per child. Cloudbeds cannot give tax advice. Check the current rules with the Tokyo Bureau of Taxation before you set it up.
What you will see on reservations
- The tax posts to the folio as one line per night, like other nightly taxes.
- When a night's price falls in a tier with no charge, no tax line appears for that night.
- When you save the tax, you choose whether existing reservations are recalculated. If you choose not to recalculate, current reservations stay as they are.
Channels and OTAs
Bookings from channels and OTAs may not carry the tiered amount yet. You can configure the tax in Cloudbeds PMS now, but check channel bookings until your channel supports it.
- Booking.com, Expedia, Agoda, and most OTAs: Cloudbeds does not push a tax definition to these channels. Whether the tiered amount appears depends on the channel sending tax amounts back on the reservation.
Limitations
- Tiered taxes are always exclusive.
- The price used is the room's price in Cloudbeds PMS. If you price rooms per person internally, the per-person split may differ from your own calculation.
- Percentage tiers and the child amount are available for Per person only.
FAQs
Should I choose Per person or Per room?
Follow your local rule. Tokyo uses the price per person, so choose Per person. Cloudbeds cannot give tax advice, so check with your tax office or accountant.
Should Taxes be ticked under Price includes?
Only if your local rule calculates the tier on a price that includes tax. Tokyo uses the price without consumption tax, so leave it unticked.
A guest's tax looks wrong. What should I check?
Open the tax in Finance > Taxes and Fees and check:
- Whether Per person or Per room is selected.
- What Price includes counts.
- The Round the price down to step.
- The date period that covers the night.
- That the tax is added to the reservation's source.
- Whether the booking came from an OTA. See Channels and OTAs.
Will changing the tax change reservations already booked?
Only if you choose to recalculate when you save the tax.
Comments
Please sign in to leave a comment.