Custom Variables

Create custom data fields for your locations and use them to personalize organic social posts and paid advertising.

Hub Feature: Custom Variables are available for Hub (franchisor) users to define location-specific data that can be used across all content.

Custom Variables allow you to add any custom data fields to your locations, then dynamically insert that data into organic social posts and paid advertising content. This enables hyper-personalized content at scale.

Overview

Custom Variables extend beyond the standard location fields (name, address, city, etc.) to include any data unique to your franchise locations:

Store-specific promotions or offers
Local manager names
Regional specialties
Custom pricing
Local event information
Unique location features

Creating Custom Variables

Step 1: Access Custom Fields

Go to Manage > Locations
Click the Custom Fields button
The Custom Fields modal will open

Step 2: Add a New Field

Click Add Field
Configure the field:
- Field Key - Internal identifier (e.g., "store_manager")
- Display Name - Human-readable name (e.g., "Store Manager")
- Field Type - Select from available types
- Is Required - Whether all locations must have this value
- Is Array - Whether the field holds multiple values

Field Types

Type	Description	Example Use
Text	Simple text input	Manager name, tagline
Email	Validated email address	Local contact email
Phone	Phone number with formatting	Direct store line
Number	Numeric values	Years in business, capacity
URL	Validated web address	Local booking page
Select	Dropdown options you define	Region, store tier
Boolean	True/false toggle	Has parking, offers delivery
Address	Structured address fields	Alternative location
Object	Complex structured data	Custom data structures

Step 3: Apply Values to Locations

Go back to the Locations table
You'll see new columns for your custom fields
Click on cells to edit values inline
Or open the location details to edit all fields

Custom Variables can be inserted into post captions using double curly brace syntax. They are dynamically replaced with location-specific values when the post is published to each workspace.

Standard Location Variables

These built-in variables are always available:

{{location_name}}    → Location display name
{{address}}          → Street address
{{city}}             → City name
{{state}}            → State/province
{{zip}}              → Postal code
{{admin_name}}       → Location admin name
{{contact_email}}    → Contact email
{{phone_number}}     → Phone number
{{website_url}}      → Website URL