Skip to main content
Skip table of contents

Create Add On Packages .ng

📆 Revision Date:

This article offers guidance on creating and managing “Add on Packages” in HotelKey. Add-on packages are non room revenue packages which typically include a package rate per person.  This is common for meetings and events covering essentials such as venue hire, refreshments, lunch, and basic audiovisual equipment.

Steps to create an Add On Package, in order of process:

  1. Create a New Package Element

  2. Create Package Headers

Step 1: Create a New Package Element

Multi Property Users:  from the HK Home, select the property and then select Property Settings under the Administration section.

Single Property Users:  From HK Home, select Property Settings under Administration

Screenshot 2025-01-12 at 3.47.34 PM.png

From the menu on the left side,

Select Rate Plan Setup and then select Package Elements.

Select Add New Package Element
(aka, Adding charge types and categories that are associated with a package)

Screenshot 2025-01-12 at 3.54.34 PM.png

For this example, we are creating a Breakfast Package. We begin by adding charge types and categories:

  • Enter a Name for the package element
    (e.g., Breakfast).

  • Enter a Code for the package element
    (e.g., BRKFST).

Note: The package element name and code are specific to your property and are used to identify the package element in the UI and in HotelKey reporting.

Screenshot 2025-04-24 at 12.44.11 PM.png

Toggle Allowances OFF as Add On Package Rates will not require an allowance.

Screenshot 2025-04-24 at 12.43.38 PM.png

Click on the blue ‘+’ symbol to configure package element pricing.

Screenshot 2025-04-24 at 12.44.42 PM.png

The Package Element Pricing window loads

  • Charge type category - select the category to which the package element is being applied from the dropdown. This will vary by property

  • Charge type - select the charge type to which the revenue from the package element is being applied from the dropdown; multiple charge types can be selected. This will vary by property

Screenshot 2025-04-24 at 12.47.32 PM.png

Complete the following fields:

Select Posting Type:  the posting types selected here, from the dropdown, will define when the revenue is posted:

  • Daily: The package amount will be broken out from the package rate daily.

  • First Day: The package amount will be broken out from the package rate on the first day only.

  • Daily Except First Day: The package amount will be broken out from the package rate daily, except for the first day, which will be included in the package rate.

  • Daily Except Last Day: The package amount will be broken out from the package rate daily, except for the last day, which will be included in the package rate.

  • Daily Except First and Last Day: The package amount will be broken out from the package rate daily, except for the first and last days, which will be included in the package rate.

  • Daily Except First Day Include Checkout Date: The package amount will be broken out from the package rate daily and on the checkout date, except for the first day, which will be included in the package rate.

Note:  Typically, for Add On Package Rates the posting type would be DAILY.

Screenshot 2025-04-24 at 12.49.39 PM.png

Quantity Type: from the dropdown, select whether the package element amount applies to all guests, adults only, or both adults and children on the reservation:

  • Fixed: The package amount applies to all guests (adults and children) on the reservation.

  • Adult: The package amount applies to all adults on the reservation.

  • Adults and Children: There is a separate package amount for adults and a separate package amount for children on the reservation.

Note:  Typically, for Add On Package Rates the quantity type would be ADULT.

Screenshot 2025-04-24 at 12.50.29 PM.png

Enter the package element amount.

Note: If you selected 'Adults and Children' under Quantity Type, you will need to enter a package amount for adults and a separate package amount for children.

If the package element amounts have seasonal pricing, click the blue calendar icon to add seasons.

Screenshot 2025-04-24 at 12.54.12 PM.png

Note, Add On Package Rates can have more than one element in the package:

If the package element requires revenue tracking against more than one charge type, you can click the blue ‘+’ sign to add on additional charge types.

Click on Save when done

Screenshot 2025-04-24 at 12.56.56 PM.png

Package Elements page loads.

Package Elements that have been created are now visible from the home screen

Screenshot 2025-04-24 at 12.58.02 PM.png

2. Create Package Headers

The following section covers creating package headers (Add On Packages)

Note - Package Elements must be set up before creating package headers, as Charge Types for the package element must be configured first.

Multi Property Users:  from the HK Home, select the property and then select Property Settings under the Administration section.

Single Property Users:  From HK Home, select Property Settings under Administration

Screenshot 2025-01-13 at 8.52.37 AM.png

From the menu on the left side,

Select Rate Plan Setup and then select Package Headers.

  • Select Add New Package Headers.

Screenshot 2025-04-24 at 1.19.04 PM.png

Complete the following fields:

Name: enter a Name for the package header. Example: 'Breakfast w/ Mickey.'

Code: enter a Code for the package header. Example: ‘BFMickey’

Linked Rate Plan: Not applicable for Add On Packages

Select Package Elements: from the dropdown, select the package elements which need to be included in the package rate.
Note: One or more package elements can be selected.

Active: toggle ON if the package is active.

Summarized Rates and Charges: toggle ON if the package elements should be rolled up in to a single charge on the folio. 

Dynamically Add Charge Amount on Rates: 

  • Not applicable for Single Image Inventory clients. 

  • For CRS clients, HotelKey will add the amount of elements on top of the Rate dynamically.

Allowed for Groups: toggle OFF for Add On Package Rates.

Calculate Taxes on Total Package Amount: toggle OFF for Add On Package Rates - tax is calculated at the charge type level.

Add On Package:  always toggle ON for Add On Packages. 

Screenshot 2025-04-24 at 2.44.55 PM.png

Allowance: Not applicable for Add On Packages - toggle OFF

Description: enter a description for your package header. Example for this package: 'Packages are per person and include setup, meal and photo session.'

The description is shown at the (info) icon on the Stay tab of a reservation and on the website where a description is provided.

Package Category: from the dropdown, select the package category:

  • Breakfast | Dinner | Lunch | Other | None

Screenshot 2025-04-24 at 2.47.33 PM.png

Consumption Start Type: from the dropdown, select when the consumption of the package elements starts:

  • Include Arrival: Package element consumption is applicable for Arrival Day

  • Exclude Arrival: Package elements consumption is not applicable for Arrival Day

  • Include Departure: Package elements consumption is applicable for Departure Day

  • Exclude Departure: Package element consumption is not applicable for Departure Day

Consumption End Type: from the dropdown, select when the consumption of the package elements ends:

  • Include Arrival: Package Element consumption is applicable for Arrival Day

  • Exclude Arrival: Package Element consumption is not applicable for Arrival Day

  • Include Departure: Package Element consumption is applicable for Departure Day

  • Exclude Departure: Package Element consumption is not applicable for Departure Day

Click on Save

Consumption Start and End Types:

Use case example 1: Breakfast packages:

Guests do not have breakfast on arrival date but guests can have breakfast on departure date.

  • Consumption Start Type: Exclude Arrival

  • Consumption End Type: Include Departure

Use Case example 2: Dinner packages:

Guests can have dinner on arrival date but guests cannot have dinner on departure date.

  • Consumption Start Type: Include Arrival

  • Consumption End Type: Exclude Departure

Screenshot 2025-04-24 at 4.39.31 PM.png

Booking Profile popup loads:

Select Booking Profile: FRONTDESK_WEB

Note: This field will populate after the package header is created.

Click on Confirm

Screenshot 2025-04-24 at 4.33.51 PM.png

From the main screen, select the Package you just created: ‘Breakfast with Mickey & Friends’

Screenshot 2025-04-24 at 4.44.46 PM.png

Charge Types:  Select the charge type to be used where the remaining balance from the package element breakout - also known as overage - would be applied to. 

Ex: the package includes a $50 credit to the restaurant and the guest uses only $40 of that credit, the $10 difference will be applied to the charge type you selected in this step.

Screenshot 2025-04-24 at 4.43.55 PM.png

Modify Periods Start Date:  the first date the package header will be available for booking.

Modify Periods End Date:  the last date the package header will be available for booking.

Active:  toggle “ON” to activate the period. 

You can add additional periods by clicking the blue ( + ) symbol.

Next, click Save on the package header screen to save your changes and close.

Screenshot 2025-04-24 at 4.51.00 PM.png

The Add On Package setup is complete. Package Elements will now be separated in the meeting room when the package is booked.

Managing Package Elements

This section covers managing the elements of add on packages - remove or modify charge types and charge categories

Multi Property Users:  from the HK Home, select the property and then select Property Settings under the Administration section.

Single Property Users:  From HK Home, select Property Settings under Administration

Screenshot 2025-01-13 at 8.23.32 AM.png

From the menu on the left side,

Select Rate Plan Setup and then select Package Elements.

  • From the list of package elements, click on the one that requires edits.

Screenshot 2025-04-24 at 1.00.37 PM.png

Removing a Charge Type:

Click on the red ( − ) symbol to remove the charge type configuration.

Note: There is no warning or confirmation message. Once you click the red ( − ), the charge type configuration will be deleted

Click the blue ( + ) sign and repeat steps to set up new revenue tracking by adding charge types.

Select Save to save your changes and close.

Screenshot 2025-01-13 at 8.29.01 AM.png

Modify the Charge Type Category or Charge Type:

On the Package Element Pricing Screen, Click on the blue “pencil” icon

  • Using the dropdown, select the Charge Type Category.

  • Click the X to remove the charge type. Then, select the Charge Type from the dropdown. 

Note: You can add additional Charge Types by using the dropdown to select Charge Type(s).

  • Select Confirm to save changes.

  • Select Save on the package element screen to save your changes and close.

Screenshot 2025-01-13 at 8.50.57 AM.png
Screenshot 2025-01-13 at 9.09.13 AM.png

Modify the Package Element Prices:

  • Click inside the price amount box (Fixed, Adult, or Child), delete the current amount, and enter the new amount.

  • Select Save on the package element screen to save your changes and close.

Note, changes in price will not impact existing bookings where this add package has already been posted on the folio.

Screenshot 2025-01-13 at 9.09.57 AM.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.