Overview
Shortcode Property Variants let you create different versions of a single shortcode’s content based on the property being viewed. This enables flexible, property-specific customization—without needing separate shortcodes for each guidebook.
🗑 Example Use Case: Rubbish Day Reminders by Property
Objective
You want to display rubbish pickup instructions specific to each property’s scheduled rubbish day, using just one shortcode.
✅ Setup Walkthrough
1. Create the Shortcode
-
Navigate to Members → Shortcodes
-
Click Create New Shortcode
-
Set:
-
Shortcode Name:
rubbish-day
-
Default Content:
Please put the rubbish out before leaving.
-
2. Enable Property Variants
-
In the shortcode modal, scroll to Advanced Properties
-
Toggle ON the setting for property variants
3. Create Variants for Each Day
➤ Variant: Monday
-
Tag Name:
Monday
-
Content:
Rubbish pickup is Monday. Please put your bins out on Sunday night.
-
Assign Properties:
Search and select all properties with rubbish day on Monday
➤ Variant: Tuesday
-
Tag Name:
Tuesday
-
Content:
Rubbish pickup is Tuesday. Please put your bins out on Monday night.
-
Assign Properties:
Select all properties where rubbish day is Tuesday
4. Save Your Work
-
After setting up each variant and assigning properties:
-
Click Save Variant
-
Once all variants are added, click Save Shortcode
-
📌 Result
In any guidebook where you use the shortcode {{{rubbish-day}}}
, guests will automatically see the correct rubbish instructions based on the property they are viewing. If no match is found, the default content will appear instead.
✅ When to Use Property Variants
Property variants are perfect for customizing:
-
Contact information by property
-
Location-specific check-in instructions
-
Local recommendations by destination
-
Widget settings (e.g. Viator activities)
-
Emergency contacts or on-site managers
-
Wi-Fi passwords or entry codes
⚙️ How Property Variants Work
-
Default Content: Displays when no variant matches the property
-
Variant Tags: Named groups (e.g., “Miami”, “Downtown”)
-
Property Assignment: Properties are assigned to specific tags
-
Automatic Selection: Guests see the correct content based on their property
🧩 Creating Shortcodes with Property Variants
Step 1: Create or Edit a Shortcode
-
Go to Members → Shortcodes
-
Click Create New Shortcode or edit an existing one
-
Fill out the basics:
-
Name (letters, numbers, hyphens, underscores only)
-
Default Content: fallback content shown if no match
-
Step 2: Enable Advanced Properties
-
In the modal, toggle Advanced Properties
-
Variant management options will appear
Step 3: Add Property Variants
-
Click Add New Tag
-
Fill in:
-
Variant Tag Name (e.g.
Beachfront
) -
Variant Content specific to the tag
-
Assign Properties to this variant
-
Step 4: Assign Properties
-
Use search to find properties
-
Click Add Selected
-
Properties appear as blue chips (click to remove)
-
⚠️ Each property can only belong to one variant per shortcode
Step 5: Save
-
Click Save Variant
-
Repeat as needed
-
Click Save Shortcode to finish
🔍 Managing Property Variants
Viewing Variants
-
Displayed as green pills, e.g.,
Beachfront (3)
(tag name and number of assigned properties)
Editing
-
Click a green pill to edit
-
Update content, tag, or assigned properties
-
Click Save Variant
Deleting
-
Click variant pill → Delete Variant
-
Confirm to unassign all properties from it
💡 Example Use Case
Scenario: Different phone numbers per city
-
Create shortcode:
contact-phone
-
Default: “Call (555) 123-0000”
-
Add variants:
-
Miami → “Call (305) 555-0001”
-
Orlando → “Call (407) 555-0002”
-
Tampa → “Call (813) 555-0003”
-
-
Guests see the correct number based on their property
🚨 Important Notes
Property Assignment Rules
-
One variant per property
-
Conflicts prompt a reassignment option
-
Unassigned properties show default content
Tag Name Requirements
-
Letters (A–Z), hyphens (-), underscores (_)
-
No spaces
-
Examples:
Beachfront
,Downtown_Location
,VIP-Guests
🛠 Troubleshooting
"Property Already Assigned" Error
-
Choose Move it to reassign
-
Choose Cancel to keep current assignment
Variant Not Showing?
-
Check property is assigned
-
Use correct syntax:
{{{shortcode-name}}}
-
Ensure variant has content and is saved
Content Not Updating?
-
Ensure both variant and shortcode are saved
-
Clear browser cache
-
Check property UUID assignment
🧠 Best Practices
-
Use descriptive tag names (e.g.
Pool_Properties
) -
Always include default content as fallback
-
Test with different guidebooks
-
Keep a record of variant assignments
-
Review and update as you add new properties
🚀 Advanced Tips
Organizing Large Portfolios
-
By location:
Miami
,Orlando
,Tampa
-
By property type:
Condos
,Villas
-
By amenities:
Pet_Friendly
,Beach_Access
Content Strategy
-
Start simple, expand over time
-
Reuse default content as base
-
Keep formatting consistent across variants
Need help? Reach out to our support team for assistance implementing property variants tailored to your setup.