Custom variables

For Hub admins. Custom variables show up in workspace context as resolved values — workspaces can't create or rename them.

Use custom variables to personalize content at scale. Examples: local offer, store manager name, regional specialty, trial pricing.

Create a custom variable

Open the field editor

Manage → Locations → Custom Fields → Add Field.

Configure the field

Field	Notes
Field Key	Internal name (e.g. `store_manager`). No spaces.
Display Name	Human label (e.g. `Store Manager`)
Field Type	See table below
Required	If on, every location must have a value
Is Array	For fields that hold multiple values

Fill values per location

Back on the Locations table, the new column appears. Click to edit inline, or open the location's detail to edit alongside everything else. For many locations at once, use Bulk upload.

Field types

Type	Use for
Text	Manager name, tagline
Email	Local contact email
Phone	Direct store line
Number	Years in business, capacity, trial price
URL	Local booking page
Select	Region, store tier (dropdown of options you define)
Boolean	Has parking, offers delivery
Address	Alternative address
Object	Complex structured data

Use in posts

Insert variables in post captions with double curly braces. Resolved at publish time, per workspace.

Standard variables (always available):

{{location_name}}  {{address}}  {{city}}  {{state}}  {{zip}}
{{admin_name}}     {{contact_email}}  {{phone_number}}  {{website_url}}

Your custom variables:

{{custom.store_manager}}
{{custom.local_offer}}
{{custom.specialty_dish}}

Inserting in the post editor: place cursor → type {{ (or click Variables) → pick from list.

Example:

Welcome to {{location_name}}! Ask for {{custom.store_manager}} and mention this post for {{custom.local_offer}}.
Visit us at {{address}}, {{city}}, {{state}} {{zip}}. Call {{phone_number}}.

Resolves per location:

Welcome to Downtown Studio! Ask for Sarah Johnson and mention this post for 15% off your first class. Visit us at 123 Main St, San Francisco, CA 94102. Call (555) 123-4567.

Use in paid ads

Custom variables work in Playbook ad copy — headlines, primary text, descriptions, CTA URLs. Same {{custom.field_key}} syntax.

In the playbook editor, variables appear as styled pills. Use Preview to confirm rendering per workspace.

Field	Pattern
Headline	`{{custom.local_offer}} at {{location_name}}`
Primary text	`Visit {{location_name}}, led by {{custom.store_manager}}.`
Description	`{{custom.tagline}} - {{phone_number}}`

Troubleshooting

Variable not resolving — check the field key is exact, location has a value, field isn't archived
Preview shows the placeholder — that workspace has no value for the field; try another or fill the value
Variable not in the selector — must be Hub context; workspace context only renders values

Bulk upload — set custom variable values for many locations at once
Locations — the table that holds the values
Creating playbooks — where variables get used in ads