| Purpose | Create, configure, share, and manage allotment blocks for Events in Groups and Events. |
| Best for | Front Desk, Manager/GM, and Admin users who create or manage group room blocks. |
| Use this when | You need to allocate group inventory, assign rates, configure release or routing rules, offer a private negotiated group rate, monitor pickup, or share a group booking link. |
| Requirements | Your property must be subscribed to the Cloudbeds Groups module, and Groups and Events must be available for your property. |
| Expected result | You can control inventory, rates, release behavior, and routing for an allotment block, monitor its pickup, and provide group guests with the appropriate Cloudbeds Booking Engine link. |
| Limitations | The Cloudbeds Booking Engine can process one booking code at a time. Guests using an allotment block link cannot apply an additional promo code to the same booking. |
Introduction
The Cloudbeds Groups and Events module brings group inventory, rates, routing, pickup, and guest booking workflows into a centralized Event workspace. Within an Event, allotment blocks specify which rooms a group may book, when they may book them, which rates apply, and when unpicked inventory is released.
One Event can contain multiple allotment blocks. For example, a property can create separate blocks for different guest segments while keeping them under the same Event, with different dates, rates, inventory, and routing rules for each block.
Start with the three areas of the Block details form: block settings, Accommodations, and Inventory release. You can then return to this guide for specific rate arrangements, routing, booking links, and ongoing block management.
Table of contents
- Who this affects and how
- Quick overview
- Access the Blocks tab
- Create an allotment block: Quick steps
- Understand the Block details settings
- Choose accommodations and inventory quantities
- Configure inventory release
- Set up a private group rate
- Configure block routing
- Manage and monitor allotment blocks
Who this affects and how
Different team members may use allotment blocks for different parts of the group workflow. Use the table below to identify the sections most relevant to your role.
| Role | What to know |
|---|---|
| Front Desk | Review block availability and pickup, and use the block management tools when helping with group reservations or sharing the group's booking link. |
| Manager/GM | Decide how inventory is allocated, which rate setup applies, how inventory should be released, and how the block is performing. |
| Admin | Configure block settings, rate plans, private group rates, routing, and other operational rules that determine how reservations from the block behave. |
Quick overview
The video below introduces allotment blocks in Groups and Events and shows how they fit into the Event workflow. Use the written sections in this article for the current setup options, private group rate behavior, and operational details.
Access the Blocks tab
The Blocks tab is located inside the Event Holistic View. Open the Event first, then use this tab to create and manage its allotment blocks.
- Log in to Cloudbeds PMS.
- From the Main Menu, click Groups and Events.
- The module opens on the Events tab. Click the name of the Event you want to manage to open the Event Holistic View.
- Select the Blocks tab. If no allotment blocks have been created for the Event, click Add block.
Create an allotment block: Quick steps
To create an allotment block, open an Event and complete the three areas of Block details: general block settings, Accommodations, and Inventory release. Only add optional settings when they apply to your group.
- From the Main Menu, open Groups and Events > Events, then open the relevant Event.
- Select Blocks and click + Allotment Block.
- Complete the Block details settings, including Block name, Stay dates, Allotment Type, and Rate.
- Under Accommodations, select the accommodation types or specific units and enter the nightly room quantities. Review the rates shown in the grid.
- Under Inventory release, choose whether unpicked-up inventory stays blocked or follows a release schedule.
- Review the settings and click Save to create the block.
The Block details form follows the same order as these steps. Selecting Stay dates makes the Accommodations and Inventory release areas available below the general settings.
For help choosing individual settings, use the detailed sections below. You can return to the Event's Blocks tab to manage the saved block later.
Understand the Block details settings
Block details is the first area of the form. It determines the block's identity, eligible stay dates, inventory method, rate, and routing. Start with the required fields, then add optional settings only when they match the group's agreement.
Core block settings
- Block name: Enter a name that helps you identify the group or inventory allocation.
- Block status: Select the status that reflects the group's booking stage, such as Lead, Tentative, or Definite.
- Stay dates: Choose the dates covered by the block. Before dates are selected, the form prompts you to select stay dates so accommodations can be added.
- Days of Week: Choose all days or limit the block to particular weekdays.
- Allotment Type: Block holds designated group inventory; Based on Availability uses the property's general availability for the selected accommodation types.
- Rate: Choose Base Rates, an existing rate plan, or Custom. Your selection determines which additional fields appear.
- Routing: Use Same as event for the Event-level routing rules, or choose an override. See Configure block routing.
- Shoulder dates: Optionally add pre-arrival and post-departure nights with a selected rate when the group may extend its stay outside the primary dates.
The core fields stay together at the top of Block details, with optional additions immediately below.
Rate choices can be used for different group scenarios. The comparison below helps you decide whether you need a standard plan, a custom block price, or a private group rate.
| If you want to... | Use this setup | What guests experience |
|---|---|---|
| Set a negotiated rate directly for this specific block | Select Custom and configure the rate directly on the allotment block. | Guests using the group booking link see the block's configured rate and inventory. |
| Use an existing rate plan for the group | Select an existing rate plan when creating the allotment block. | The group booking link displays the rate plan for the applicable block inventory and dates. |
| Keep an existing negotiated rate private from normal public Booking Engine searches | Use a promo-coded rate plan, keep Website/Booking Engine enabled as a source, and attach the rate plan to the allotment block. | The negotiated rate appears automatically through the group booking link, without the guest entering the promo code. Normal public searches do not display that rate. |
When Custom is selected in the Rate field, additional controls become visible, including Prefill from rate plan, Policy, Segment, and an option to add Restrictions. These controls do not appear in every rate setup.
Expand the optional settings below when you need to customize pricing or the booking conditions.
Custom pricing and prefill from a rate plan
Select Custom in Rate to enter block-specific pricing. To avoid entering every rate from scratch, choose an existing plan under Prefill from rate plan, or keep None to enter amounts manually.
The prefill copies pricing as a starting point and does not maintain a live link to the source rate plan. After selecting accommodations, review the rates in the pricing grid, adjust them as needed, and use Show extra guest pricing to see the additional guest amounts.
Custom rate restrictions
When Rate is set to Custom, select + Restrictions to add optional booking conditions. The controls include MinLOS, MaxLOS, Cut-off, Last minute, Closed to Arrival, and Closed to Departure. Complete only the fields that apply to the group. Select Remove to remove the Restrictions section.
After adding Restrictions, the booking-condition fields appear directly inside the expanded section.
Shoulder dates and their rate
Select + Shoulder dates to configure nights before the main arrival date or after the main departure date. Set the Pre-arrival and Post-departure day counts and select the applicable Rate. The section appears below the core block settings and can be removed if it is no longer needed.
The expanded Shoulder dates area lets you choose an extension period and a rate independently of the main stay.
Choose accommodations and inventory quantities
The Accommodations area defines what guests can reserve from the block. It becomes available after you enter Stay dates. You can allocate a quantity of accommodation types or hold specific physical units, depending on the group's needs.
- Accommodation Type: Select room categories and set how many accommodations are held for the applicable nights. Use this when a particular unit assignment is not required.
- Unit: Select specific physical rooms or units when those exact accommodations must be held for the group.
- Show extra guest pricing: Turn this on when you need to inspect additional guest prices while reviewing block rates.
After selecting accommodation types or units, use the day-by-day grid to review each date's allocation. The availability figures help you compare the planned block quantity with the property's remaining availability.
If you need to adjust many nights, expand the editing guidance below. Individual date values can also be adjusted directly in the grid.
Bulk Edit inventory across dates
Use Bulk Edit instead of changing each nightly value individually. Select the Bulk Edit icon next to the relevant accommodation type or unit.
- In Bulk Edit, choose the Accommodation Types, Date Range, and Days of Week.
- Enter the number of Blocked rooms.
- Enter the Rate amount (optional).
- Select Apply.
- Confirm the updated values in the nightly inventory grid. Select an individual date value if you need to fine-tune it.
After you select Apply, the grid reflects the updated nightly room quantities and rates.
When to select specific units
Configure inventory release
Use Inventory release to decide when unpicked-up rooms in an allotment block return to general availability. This is the third area of the Block details form, after Accommodations. You can configure it while creating a block or return later through Edit Allotment Block. It is not the old Release Schedule field that appeared beside Allotment Type.
- From the Main Menu, go to Groups and Events > Events and open the Event.
- On the Blocks tab, either select + Allotment Block to create a block or open the existing block's three-dot menu and select Edit Allotment Block.
- In Block details, complete or review the block settings and Accommodations. Scroll to Inventory release.
- Choose Do not release, Release all at once, or Release one night at a time according to the group's agreement. Complete any fields shown for the selected option.
- Review the dates and amounts of inventory to be released, then select Save when creating a block or Update when editing one.
Which option should I use? Choose Do not release when you want to release inventory manually; Release all at once when all remaining rooms across the stay should be released together; or Release one night at a time when each stay night needs its own schedule. The latter supports a single cutoff or a series of release tiers.
Expand the scheduling option that matches your group's release arrangement to see which fields to complete.
Release all at once
Release one night at a time: days before arrival or specific date
Release one night at a time: tiered schedule
Use Tiered when a group agreement calls for multiple inventory reductions on different dates or at different times, such as a negotiated attrition schedule. The tier settings are inside Release one night at a time, not a separate allotment type.
- Select Release one night at a time and choose Tiered.
- Use the Inventory to release selector to choose a percentage (%) or a number of units.
- For each tier, set Release date and time, Inventory to release, and Accommodation Types. Use + Tier to add further tiers, or Remove to delete a tier you do not need.
- Optionally enable Auto-calculate final tier. The interface describes this as releasing whatever inventory remains after earlier tiers.
- Review the Blocked and Allocated summary displayed beneath the tiers. If the form warns about the quantities or schedule, correct the fields before saving or updating the block.
Example: If a group contract provides for an initial inventory reduction and a later release of the remaining unpicked-up rooms, create a tier for each agreed cutoff. Enter the dates and release amounts from the contract, then use the on-screen allocation summary to review the configured schedule.
Set up a private group rate
Use a private group rate when a group or corporate account has a negotiated rate that should be available through its allotment block booking link but hidden from guests browsing the public Cloudbeds Booking Engine without the promo code.
Need to create or update the rate plan? For the complete workflow for creating and editing rate plans and packages, see Rate Plans and Packages - Everything You Need to Know. The steps below focus only on the settings required to use that rate plan as a private group rate.
- From the Main Menu, go to Rates and Availability > Rate Plans and Packages, then create a new rate plan or edit the existing rate plan that contains the negotiated group rate.
- In the rate plan settings, set Promotion Code to Yes and enter the promo code. Keep the code private if only the intended group should have direct access to it.
- Under Which sources is the rate plan available for?, keep Website/Booking Engine selected.
Keep Website/Booking Engine enabled. Removing this source can prevent guests from completing reservations through the group booking link.
- Open the Event in Groups and Events and select the Blocks tab.
- Create the allotment block and select the promo-coded rate plan in the Rate field.
- Allocate the applicable Accommodation Types or Units and dates to the block.
- Set the block to Definite when it is ready for guest booking.
- Copy the booking link from the Booking Code / URL column and share it with the group.
Expand the sections below to see how the private group rate appears to guests, which dates and accommodations they can book, and how taxes and fees apply.
What guests see with a private group rate
When a guest opens the allotment block booking link, the Cloudbeds Booking Engine automatically applies the block code and displays the negotiated rate for the accommodation types and dates available through that block. The guest does not need to enter the rate plan's promo code.
The same rate remains hidden when a guest browses the public Cloudbeds Booking Engine without the promo code.
Anyone who knows and enters the promo code in the public Cloudbeds Booking Engine can still access the rate according to the rate plan's configured accommodation types and dates. Keep the promo code private when the negotiated rate should only be shared with the intended group.
The Cloudbeds Booking Engine processes one booking code at a time. A guest using the allotment block booking link cannot apply a different promo code to the same booking.
Guests can continue through checkout with the negotiated rate applied to the reservation.
Dates and inventory available through the group link
Taxes and fees for group booking links
A private group rate controls access to the negotiated rate. It does not create a separate reservation source for taxes and fees.
Reservations created through the group booking link use the Website/Booking Engine source. Taxes and fees configured for that source therefore continue to apply to the reservation.
A private group booking link is not a tax-exemption method. For more information about source-based tax behavior, see Taxes and fees FAQs.
Configure block routing
Use the Routing field to define how transactions from reservations created from the allotment block are routed to folios.
The Event-level routing rule acts as the default for the Event. If an allotment block has its own routing rule, the block-level rule takes precedence for reservations created from that block.
Available routing options include:
The routing rule setup displays the transaction types included in the selected option and the folio where those transactions should be sent. When using Custom, select the transaction types to route.
Block-level routing changes apply going forward. Transactions posted before the routing rule is changed keep their current folio assignment. To adjust those transactions, move them manually from the folio.
You can review active custom routing rules from the Event Details tab. This helps confirm which allotment blocks have custom routing without opening each block individually.
Manage and monitor allotment blocks
After an allotment block is active, use the Blocks and Pickup views to monitor inventory consumption, release status, guest access, and block performance.
Review block performance
- Granular Inventory Grid: Click the arrow next to the block name to expand the day-by-day view. Review the blocked, picked-up, and available quantities by Accommodation Type and date.
-
Block Performance Summary: Use the main Blocks table to review:
- Picked / Allotted: The number of rooms reserved against the allocated inventory.
- Release Status & Schedule: The status and timing of the block's inventory release rules.
- Booking Code / URL: The unique block code and link used for guest self-booking through the Cloudbeds Booking Engine.
- Block Actions: Open the three-dot menu to Edit Allotment Block, Release individual dates, or Delete the block.
Routing edits apply to transactions posted after the change. Existing posted transactions keep their current folio assignment.
For a broader explanation of the Event workspace and its tabs, see Event Holistic View overview.
Expand the sections below for block edits, pickup tracking, and sharing a group booking link.
Change an existing block's rate plan
You can change an existing block's selected Rate without recreating the block, but only while no reservations are linked. Once a reservation is linked, the rate selection becomes read-only.
- From the Main Menu, go to Groups and Events > Events, open the Event, and select Blocks.
- Open the relevant block's three-dot menu and select Edit Allotment Block.
- If the block has no linked reservations, change Rate, review any affected prices and settings, and save.
- If Rate is locked, check whether a reservation is already linked to the block. Do not expect this field to be editable in that state.
In an eligible block, the Rate field remains available for selection.
When a reservation is linked, the Rate field is displayed as unavailable.
Track pickup
Open the Event in Groups and Events, then select the Pickup tab to review how many rooms have been reserved against the allocated inventory.
- Day-by-Day Breakdown: Review Blocked and Picked-up quantities for each date in the Event range.
- Room-Type Performance: Review pickup by accommodation category.
- Block Filter: Use the Allotment Block dropdown to switch between blocks within the same Event.
- Release Inventory: Return unpicked-up rooms to general inventory for selected dates without waiting for an automatic release.
- Edit: Update the allotment configuration when the group's needs change.
Share the Cloudbeds Booking Engine link
Open the Event in Groups and Events, then select the Blocks tab to copy the booking link for the intended allotment block.
- Locate the allotment block.
- Find the Booking Code / URL column.
- Click the copy-link icon.
- Share the generated link with the group.
Why use this link? The URL includes the allotment block code. When guests open it, the Cloudbeds Booking Engine displays the applicable block dates, inventory, and rate without requiring them to enter the group code manually.
If the block uses a promo-coded rate plan, the negotiated rate is displayed automatically through the group booking link. Guests do not need to enter the promo code. See Set up a private group rate for the complete setup and limitations.
Related articles
Now that you know how to create and manage allotment blocks, use these resources for more information about the broader Event workspace and Event setup:
Comments
Please sign in to leave a comment.