Overview
Shortcode property variants (called Per-property versions in the members area) let one custom shortcode show different content depending on which property’s guidebook the guest is viewing. You keep a single {{{shortcode}}} in your guides, and each property gets the right text—without needing separate shortcodes for each guidebook.
Pro feature
Creating and editing custom shortcodes needs Guidebook Pro (or BetterSTR Simple on any property, or your free trial). Without it, the Custom Shortcodes page still lists your existing shortcodes but shows Upgrade to Pro instead of New shortcode.
🗑 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
In the left menu, open Guidebooks → Custom Shortcodes (1)
Click New shortcode at the top right (2) (or Create a shortcode in the Actions panel)
Set:
Name:
rubbish-dayContent (the default everyone else sees):
Please put the rubbish out before leaving.
2. Turn on Per-property versions

Below the Content box, switch on Per-property versions (1)
Click Add a version (3) for each group of properties. Versions you add appear as purple pills (2).
3. Create Versions for Each Day

➤ Version: Monday
Version name (1):
MondayContent for these properties (2):
Rubbish pickup is Monday. Please put your bins out on Sunday night.Properties (3):
Type 2 or more letters of a property name or address, then click each property with rubbish day on Monday
➤ Version: Tuesday
Version name:
TuesdayContent for these properties:
Rubbish pickup is Tuesday. Please put your bins out on Monday night.Properties:
Add all properties where rubbish day is Tuesday
4. Save Your Work
After setting up each version and adding its properties:
Click Save version (4)
Once all versions are added, click Save Shortcode. Versions aren’t kept until you save the 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 the property isn’t in any version, the default content appears 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 code (e.g. Viator activities)
Emergency contacts or on-site managers
Wi-Fi passwords or entry codes
Widget code such as an <iframe> or <script> only shows in guides for properties on Guidebook Pro (or a trial); otherwise it’s removed from the shortcode’s output.
⚙️ How Property Variants Work
Default content: the shortcode’s Content box, shown when the property isn’t in any version
Versions: named groups (e.g., “Miami”, “Downtown”), each with its own content
Properties: each version lists the properties that should see it
Automatic selection: guests see the correct content based on the property whose guide they’re viewing
🧩 Creating Shortcodes with Property Variants
Step 1: Create or Edit a Shortcode
Go to Guidebooks → Custom Shortcodes
Click New shortcode, or click an existing shortcode in the list to edit it
Fill out the basics:
Name (letters, numbers, hyphens, underscores only)
Content: the default, shown if the property isn’t in a version
Step 2: Turn on Per-property versions
In the shortcode window, switch on Per-property versions
The list of versions and the Add a version button appear
Step 3: Add a Version
Click Add a version
Fill in:
Version name (e.g.
Beachfront)Content for these properties
Properties that should see this version
Step 4: Add Properties
Type 2 or more letters of a property’s name or address in the Properties box
Click a property in the list to add it
Added properties appear as blue chips (click a chip to remove it)
⚠️ Each property can only belong to one version per shortcode
Step 5: Save
Click Save version
Repeat as needed
Click Save Shortcode to finish
🔍 Managing Property Variants
Viewing Versions
In the shortcode window, versions show as purple pills, e.g.,
Beachfront 3
(version name and number of properties in it)The Custom Shortcodes list shows the same pills under each shortcode, and the Per property filter shows only shortcodes that have versions
Editing
Open the shortcode, then click a purple pill to edit that version
Update the name, content, or properties
Click Save version, then Save Shortcode
Deleting
Click the version pill → Delete version
Confirm. Its properties go back to the default content.
Click Save Shortcode to keep the change
💡 Example Use Case
Scenario: Different phone numbers per city
Create shortcode:
contact-phoneDefault: “Call (555) 123-0000”
Add versions:
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 Rules
One version per property, per shortcode
Adding a property that’s already in another version asks whether to move it
Properties not in any version show the default content
Version Name Requirements
Letters (A–Z), hyphens (-), underscores (_), up to 50 characters
No spaces or numbers
Examples:
Beachfront,Downtown_Location,VIP-Guests
🛠 Troubleshooting
“Is in the … version. Move it to this one?”
Click OK to move the property into the version you’re editing
Click Cancel to keep it where it is
Variant Not Showing?
Check the property is in the version (open the shortcode and click the pill)
Use correct syntax:
{{{shortcode-name}}}(three braces)Ensure the version has content and you clicked Save Shortcode afterwards
Content Not Updating?
Ensure both the version and the shortcode are saved
Reload the guide in your browser
Check what a property will show: open the property and choose Property Shortcodes in its Actions panel. Your shortcodes there shows that property’s version where it has one.
🧠 Best Practices
Use descriptive version names (e.g.
Pool_Properties)Always include default content as fallback
Test with different guidebooks
Keep a record of which properties are in each version
Review and update as you add new properties
🚀 Advanced Tips
Organizing Large Portfolios
By location:
Miami,Orlando,TampaBy property type:
Condos,VillasBy amenities:
Pet_Friendly,Beach_Access
Content Strategy
Start simple, expand over time
Reuse default content as base
Keep formatting consistent across versions
Need help? Reach out to our support team for assistance implementing property variants tailored to your setup.