Title: Luggage Tags

1. Article Information

Field

Description

Category

Application

Audience

Business Support

Skill Level

Beginner

Owner

Team

Last Updated

8 Jan 2026

Current Version

V1.0


2. Version / Change History

Version

Date

Change Description

Author

1.0

8 Jan 2026

Initial creation

Nichole McLachlan


Note: Use 1.0 for the first approved release, 1.x for minor, non-breaking updates (wording, screenshots, notes), and 2.0+ for major procedural, system, or security changes that alter how the task is performed.


3. Purpose

The luggage tags or bag tags are produced at the Hamilton Island airport to tag guest bags with their details to ensure the bags are delivered to the right rooms/locations.


4. Scope & Applicability

Systems or services affected:

  • Agilysys Versa

Environments:

  • Production
  • UAT

Roles permitted to perform this task:

  • Business Application Support

 

5. Prerequisites

Before starting, ensure:

  1. Agilysys Versa Login
  2. Basic HTML knowledge


6. Expected Outcome

After completing this task:

The luggage tag template should be created/edited/updated successfully in Agilysys Versa. 

How success is confirmed:

  1. The luggage tags should be able to print successfully on the specific luggage tag printer located on Hamilton Island. 
  2. The luggage tags should contain the full name, room number, arrival and departure details of the guest. 


7. Warnings / Important Notes ⚠️

Security considerations:

  • N/A

Downtime or user impact:

  • No downtime, however updated luggage tags might not be able to be printed until saved to production. 

Common mistakes to avoid:

  • Ensure printer driver and settings match the specific luggage tag printer located on Hamilton Island. 

 

General Notes:

  1. The luggage tags are printed on specific labels on a specific label printer. 
  2. The luggage tags are printed, then folded in half around the handle of the luggage. The ends of the sticker is peeled off and stuck together. 
  3. The Holiday Homes Logo is currently hosted on MS360 (Cloudberry) and the URL is in the HTML Code snippets. 


8. Troubleshooting (Before You Begin)

Issue

Possible Cause

Resolution

Luggage Tag doesn’t print

Luggage tag not set up in Agilysys Versa

Set up luggage tag in Agilysys Versa

Luggage Tag doesn’t print correctly

Printer settings not set up properly

Check printer settings to ensure it’s set up for luggage tag printer on island


9. Rollback / Recovery (If Applicable)

Steps to reverse the change if required.

  1. When editing create a new template based on the existing template and use that to make changes/test on before going live. 
  2. Revert back to original template if needed.


10. Related Articles / References

Internal Knowledge Base links

  • N/A

Vendor documentation

  • ?

Policies or standards

  • N/A


 

11. Step-by-Step Procedure

Step 1: Create Luggage Tag (Bag Tag) 

Description: Creates a luggage tag in Agilysys Versa to enable luggage tags to be printed on Hamilton Island. 

Login URLS:

UAT: 

URL: https://visualone.onagilysys.sg/pms/#/login

Customer ID: 1012

User ID: 

Password: 

 

PRODUCTION: 

URL: https://visualone.onagilysys.sg/pms/#/login

Customer ID: 1013

User ID: 

Password: 

 

 


 

Go to: Settings -> Utilities -> Distribution List -> Templates -> Tag Templates

 

 

 

A screenshot of a computerAI-generated content may be incorrect.

 

OR

 

Click on the search button and type in Tag and select Templates -> Tag Templates

 

 

 

To create a new tag template – click on Create Tag Template
 

A screenshot of a computerAI-generated content may be incorrect.

  1. Enter in the Tag Code: 
  2. Enter in the Tag Name:
  3. Enter the List Order: 
  4. Select if it’s Active
  5. Select if it’s to be used as the Default Tag Template. 
  6. In the body of the tag template, enter the details you want to show up on the tag. 
  7. You can do this by selecting from the Tags on the right side bar or by entering in your own copy/content. There is a rich text editor which allows you to do some basic formatting but keep in mind the printer may not support all formatting.
  8. To add a tag, place the cursor where you want the Tag and click on the tag name – the field code will appear in the body of the template. The Tags pull directly from the reservation in Agilysys Versa. 

 

Note: You can preview the template whilst you are in creation mode BUT the preview is not always reflective of what actually prints out. 

A screenshot of a computerAI-generated content may be incorrect.

 

 

When you’re happy with your luggage tag, click on Create to save it as a template.

 

 

Step 2: Edit/Update Luggage Tag (Bag Tag)

  1. Go to: Settings -> Utilities -> Distribution List -> Templates -> Tag Templates
     
    A screenshot of a computerAI-generated content may be incorrect.  A screenshot of a computerAI-generated content may be incorrect.

 

OR

 

  1. Click on the search button and type in Tag and select Templates -> Tag Templates
     
     

 

  1. To edit an existing tag template, under the Actions heading, click on the edit (pad & pencil) icon
     
    A screenshot of a computerAI-generated content may be incorrect.

 

Note: You can preview the template whilst you are in editing mode BUT the preview is not always reflective of what actually prints out. 

A screenshot of a computerAI-generated content may be incorrect.

 

To save the changes to the template, click on Update. 

A screenshot of a computerAI-generated content may be incorrect.


 

Step 3: HiHH Luggage Tag – CODE

The luggage tag for Holiday Homes is currently designed using HTML code (see Appendix A). The template has the ability to enter HTML Snippets. 

 

You will see when editing the template that there are two HTML Snippets – these are exactly the same code but we’ve duplicated it to ensure it prints twice for each folded side. 

 

To edit the HTML Snippet

Edit the template and then click on the pencil icon next to the snippet you want to edit. 

It may be worth copying the HTML code and working in a HTML editor rather than trying to edit within the snippet box, as it’s quite small. 

When you’re happy with the code, click on the green tick and then click on Update to save the template. 

A screenshot of a computerAI-generated content may be incorrect.


 

Step 4: Verification/Printing

To validate your changes, test it by printing out a label. There is a label printer located on the island and also in IT in the Corporate Office. See example (Appendix B).

To print out: 

  1. Login to Versa, click on the Reservations tab. 
     Find a reservation that has:
    • a Confirmation number
    • has a status of Reservation
    • a room number allocated
    • preferably 2 guests 

  1. View the reservation. On the right side menu, scroll down to Print Cards & Tags. 

A screenshot of a computer screenAI-generated content may be incorrect.

  1. On the pop up, de-select Registration Cards as we only want to test the luggage tag. 
  2. Choose the luggage tag template you just created or updated eg HH001 and the number of tags you want to print. 

A screenshot of a computer screenAI-generated content may be incorrect.

  1. This will pop up with a print view page – ensure you select the label printer so that it shows correctly and then print so that you can see if it’s printing correctly. 

 


 

APPENDIX A – Sample Code for HiHH Luggage Tag 1

<meta charset="UTF-8">

<title>Hamilton Island Holiday Homes Luggage Tag</title>

<meta name="viewport" content="width=device-width,initial-scale=1">

<style>

/* Basic print-friendly reset */

html, body {

    height: 100%;

    margin: 0;

    padding: 0;

    font-family: "Helvetica Neue", Arial, Helvetica, sans-serif;

}

</style>

<div style="width:120mm; /* typical tag width; change if needed */

     height:200mm;       /* long tag height similar to sample */

     margin:0 auto;

     background:#fff;

     border:1px solid #e6e6e6;

     box-sizing:border-box;

     position:relative;

     overflow:hidden;

      -webkit-print-color-adjust:exact;"> <br>

  <br>  <br>

  <br>  <br>

  <br>  <br>

  <br>  <br>

  <br>  <img width="40%" src="https://hamiltonisland-inntopia.s3.ap-southeast-2.amazonaws.com/CRM-Images/HIHH_logo_bw.jpg">

  <div style="font-size:40px; padding-top:50px;line-height:1.2; color:#000; writing-mode:vertical-rl; text-orientation:mixed;text-align:top;"> Welcome<br>

    {{{FullName}}} <br>

    <strong>Room # {{{RoomNo}}}</strong> </div>

</div>

<style>

/* Basic print-friendly reset */

   html,body {

   height:100%;

   margin:0;

   padding:0;

   font-family: "Helvetica Neue", Arial, Helvetica, sans-serif;

   }

</style>

<div style="width:120mm; /* typical tag width; change if needed */

     height:130mm;       /* long tag height similar to sample */

     margin:0 auto;

     background:#fff;

     border:1px solid #e6e6e6;

     box-sizing:border-box;

     position:relative;

     overflow:hidden;

      -webkit-print-color-adjust:exact;">

  <div style="position:absolute;

       display:flex;

       flex-direction:column;

       align-items:left;

        box-sizing:border-box;">

    <div style="font-size:40px; padding-top:50px; line-height:1.2; color:#000; writing-mode:vertical-rl; text-orientation:mixed;text-align:top;"> Arrival: {{{Arrival}}}<br>

      Departure: {{{Depart}}} </div>

  </div>

</div>
 APPENDIX B – Sample Print Out
 

A white paper with black text on itAI-generated content may be incorrect.