Facebook Tracking Pixel

Shortcode Property Variants - For Property Managers

May 30, 2025 1,169 views Barry Murphy
Easily tailor shortcode content for specific properties—such as local instructions, contact info, or rubbish day pickup using Property Variants. Manage everything from one shortcode, while customizing content per property with precision.

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

The Custom Shortcodes page: (1) Custom Shortcodes in the menu, (2) the New shortcode button, (3) a shortcode's per-property versions with the number of properties in each

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-day

    • Content (the default everyone else sees):
      Please put the rubbish out before leaving.


2. Turn on Per-property versions

The shortcode window: (1) the Per-property versions switch, (2) the versions you've added, (3) Add a version, (4) Save Shortcode

  • 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

The Add Property Version window: (1) Version name, (2) Content for these properties, (3) Properties search with the chosen properties as blue chips, (4) Save version

➤ Version: Monday
  • Version name (1): Monday

  • Content 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: Tuesday

  • Content 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

  1. Default content: the shortcode’s Content box, shown when the property isn’t in any version

  2. Versions: named groups (e.g., “Miami”, “Downtown”), each with its own content

  3. Properties: each version lists the properties that should see it

  4. 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

  1. Create shortcode: contact-phone

  2. Default: “Call (555) 123-0000”

  3. Add versions:

    • Miami → “Call (305) 555-0001”

    • Orlando → “Call (407) 555-0002”

    • Tampa → “Call (813) 555-0003”

  4. 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, 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 versions


Need help? Reach out to our support team for assistance implementing property variants tailored to your setup.