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.
Explore Digital Guestbooks
Property Variants are just one of the powerful features in your BetterSTR Digital Guestbook. Discover what else you can do to streamline your property management.