Overview
This article serves as a lookup reference for template variables available in Localist Events Liquid templates. The Theme Editor organizes templates into logical groups—each group is listed below with all available templates and their variables.
Templates often inherit variables from parent templates. Inheritance relationships are noted where they exist. All templates have access to global variables (site, current_user)—see Article 2 for the complete global reference.
How to Use This Reference
- Identify which template is being edited in the Theme Editor.
- Locate that template in the appropriate section below (templates are grouped by function).
- Review the variable table to see what data is available for use in the template.
- If a template inherits from another, check the parent template’s variables as well.
Information Templates
README
No template-specific variables. Uses only global variables.
Public Help Page
No template-specific variables. Uses only global variables.
Wrapper Templates
Global Site Shell
| Variable | Type | Description |
|---|---|---|
content_for_layout | String | The fully rendered page HTML, inserted inside main |
page_title | String | The primary title rendered in the HTML <title> tag and page header |
page_subtitle | String | A secondary title displayed below the page title, if applicable |
meta_description | String | The content for the page’s <meta name="description"> tag, used by search engines |
meta_subdescription | String | Text concatenated immediately after meta_description in that same meta tag when present |
body_class | String | CSS class names applied to the <body> element for page-specific styling |
body_id | String | The HTML id attribute applied to the <body> element |
page_class | String | Additional CSS classes merged into the <body> element’s class attribute (together with body_class) for template-specific styling |
should_show_survey | Boolean | Internal. Drives an older user-feedback survey mechanism. Theme authors should not rely on this. |
Site Header
No template-specific variables. Uses only global variables.
Site Footer
No template-specific variables. Uses only global variables.
Search Bar
No template-specific variables. Uses only global variables.
Menu Links
No template-specific variables. Uses only global variables.
Events Templates
Page Shell
The Past, Conference, and Session page shells share this variable set. Theme authors editing those shells can reference the same variables.
| Variable | Type | Description |
|---|---|---|
num_attendees | Integer | Count of entries in the visible attendee list for the event (subject to visibility and platform options) |
show_map | Boolean | Whether the event has a valid location and the map should be rendered |
ticket_data | JSON string | Internal. Serialized configuration consumed by the registration/checkout client UI. Theme authors should treat this as opaque and pass it through to the existing register/checkout markup. |
conference_ticket_data | JSON string | Internal. Same shape as ticket_data, scoped to the parent conference event. |
feedback_time_not_expired | Boolean | Whether the feedback submission window is still open for this event |
requesting_feedback | Boolean | Whether the user is being prompted for feedback |
event_feedback | Object | Feedback configuration for this event |
event_feedback_responses | Hash | User’s existing feedback responses |
event_feedback_status | String | Current feedback submission status |
open_survey | Boolean | Whether the feedback survey is open for responses |
Past Page Shell
Shares the same variable set as Page Shell above.
Conference Page Shell
Shares the same variable set as Page Shell above.
Session Page Shell
Shares the same variable set as Page Shell above.
Public Event Submission Form
| Variable | Type | Description |
|---|---|---|
event | Event | The event being created or edited |
filters | Hash | Available filter options by filter category |
visible_sections | Hash | Which form sections are visible (keyed by section name) |
groups | Array | Groups for selection (label/value option list) |
departments | Array | Departments for selection (label/value option list, requires Departments) |
selected_groups | Array | Groups already associated with the event |
selected_departments | Array | Departments already associated with the event |
selected_tags | Hash | Tags grouped by context (each value is an array of tags for that context) |
visibility_options | Array | Event visibility options (Public, Unlisted, Restricted) |
experience_options | Array | Available experience types for the event |
status_options | Array | Event status options; values are live, canceled, postponed, soldout |
has_zoom_integration | String (‘true’/’false’) | Whether the platform’s Zoom integration feature is enabled |
zoom_status | String | Zoom UI state for the editor: “unauthorized” (no Zoom token), “no_meeting” (token but no meeting on the event), or “meeting” (stream/meeting linked) |
limited_edit | Boolean | True when the event is not new and its first start date is today or in the past, so certain fields are locked down |
future_plans | Array | Upcoming user plans (set for the edit flow; optional for layout) |
User Multi-Date Select
No template-specific variables. Uses only global variables.
Invite Friends
No template-specific variables. Uses only global variables.
Speakers
No template-specific variables. Uses only global variables.
Sidebar on Edit Page
No template-specific variables. Uses only global variables.
Event Attendee Box
| Variable | Type | Description |
|---|---|---|
num_attendees | Integer | Count of entries in the visible attendee list for the event (subject to visibility and platform options) |
Event Action Buttons
| Variable | Type | Description |
|---|---|---|
ticket_data | JSON string | Internal. Pass through to the existing register/checkout markup; do not modify. |
Current Event Status
| Variable | Type | Description |
|---|---|---|
attendance | Attendance data | User’s attendance status and related registration data for this event |
Event Interest Button
No template-specific variables. Uses only global variables.
Registration Required
No template-specific variables. Uses only global variables.
Conference Navigation Header
| Variable | Type | Description |
|---|---|---|
conference_ticket_data | JSON string | Internal. Pass through to the existing register/checkout markup; do not modify. |
Add to Calendar
No template-specific variables. Uses only global variables.
Admin Editor Tools
No template-specific variables. Uses only global variables.
Actions
| Variable | Type | Description |
|---|---|---|
ticket_data | JSON string | Internal. Pass through to the existing register/checkout markup; do not modify. |
Dates
No template-specific variables. Uses only global variables.
Description
No template-specific variables. Uses only global variables.
Event Details
No template-specific variables. Uses only global variables.
Editor Tools
No template-specific variables. Uses only global variables.
Map
No template-specific variables. Uses only global variables.
Event Meta Data
No template-specific variables. Uses only global variables.
Owner Editor Tools
No template-specific variables. Uses only global variables.
People
| Variable | Type | Description |
|---|---|---|
num_attendees | Integer | Count of entries in the visible attendee list for the event (subject to visibility and platform options) |
Photo
No template-specific variables. Uses only global variables.
Register
| Variable | Type | Description |
|---|---|---|
ticket_data | JSON string | Internal. Pass through to the existing register/checkout markup; do not modify. |
Stream
No template-specific variables. Uses only global variables.
Activity
No template-specific variables. Uses only global variables.
Location
No template-specific variables. Uses only global variables.
Featured Groups
No template-specific variables. Uses only global variables.
Featured Users
No template-specific variables. Uses only global variables.
Event Speakers
No template-specific variables. Uses only global variables.
User’s Conference Agenda
| Variable | Type | Description |
|---|---|---|
user_events | Array | User’s selected conference sessions |
Conference Schedule
No template-specific variables. Uses only global variables.
Search Results & Month Views Templates
Search Results Page Shell
| Variable | Type | Description |
|---|---|---|
event_count | Integer | Total number of events matching the current search or filter criteria |
people_count | Integer | Total number of users matching the current search criteria |
group_count | Integer | Total number of groups matching the current search criteria |
department_count | Integer | Total number of departments matching the current search criteria |
place_count | Integer | Total number of places matching the current search criteria |
in_search | Boolean | Whether the current page is displaying search results (vs. a browsing/calendar view) |
search | String | Current search query |
no_results | Boolean | Whether the search or filter returned zero results across all entity types |
settings | Hash | Current search parameters |
mode | String | Current view mode on unified search/calendar: “search”, “browse”, or “calendar”, depending on the current flow |
view_type | String | The current calendar view mode (e.g. month, week, day, upcoming) |
showing_past | Boolean | Whether the results include past events (vs. only upcoming events) |
sort_options | Array | Available sort options (label/value pairs) |
show_sort_options | Boolean | Whether the sort-order dropdown should be displayed |
filter_type_options | Hash | Filter options organized by filter category |
search_list | Search List or nil | Saved search configuration |
show_people | Boolean | Whether the People results tab should be displayed |
show_events | Boolean | Whether the Events results tab should be displayed |
show_groups | Boolean | Whether the Groups results tab should be displayed |
show_departments | Boolean | Whether the Departments results tab should be displayed |
show_places | Boolean | Whether the Places results tab should be displayed |
previous_link | String | URL to the previous page of search results, or nil if on the first page |
next_link | String | URL to the next page of search results, or nil if on the last page |
today | Date | The current date, used for calendar highlighting and date comparisons |
date_range | String | Current date range for filtering |
results | Array | Results for the currently active search category |
calendar_of | String | Machine-readable calendar context (e.g. channel, group, user, business); pair with origin_name or other fields when displaying a label |
origin_name | String | When location-based search is used: a location label (e.g. from geocoding). In channel calendar search: the channel page title. Often nil |
Search Results List
No template-specific variables. Uses only global variables.
Filter Events Dropdown
| Variable | Type | Description |
|---|---|---|
filter_type_options | Hash | Filter options organized by filter category |
sort_options | Array | Available sort options (label/value pairs) |
show_sort_options | Boolean | Whether the sort-order dropdown should be displayed |
Right Sidebar
No template-specific variables. Uses only global variables.
Mini Calendar Navigation
| Variable | Type | Description |
|---|---|---|
previous_month_link | String | URL to navigate to the previous month’s calendar view |
next_month_link | String | URL to navigate to the next month’s calendar view |
today | Date | The current date, used for calendar highlighting and date comparisons |
Subscription Links
No template-specific variables. Uses only global variables.
User & Place Calendar Page Shell
| Variable | Type | Description |
|---|---|---|
calendar_for | String | The entity instance this calendar is for (the “whose calendar” object) |
calendar_of | String | The calendar context type: e.g. “user”, “business”, “group”, “channel” |
start_day | Date | The first date in the visible calendar range |
end_day | Date | The last date in the visible calendar range |
today | Date | The current date, used for calendar highlighting and date comparisons |
view_type | String | The current calendar view mode (e.g. month, week, day, upcoming) |
is_this_month | Boolean | Whether the calendar is currently showing the present month |
selected_types | Array of String | The event type filters currently applied by the viewer |
show_sort_options | Boolean | Whether the sort-order dropdown should be displayed |
distance_options | Array | Available distance filter options (label/value pairs) |
settings | Hash | Search parameters (start_date, end_date, hide_recurring, near, within, card_size, experience) |
skip_filters | Boolean | Whether to hide the event filter controls on this calendar view |
skip_experience_option | Boolean | Whether to hide the in-person/virtual/hybrid experience filter |
filter_type_options | Hash | Filter options organized by filter category |
places | Array | Available places for filtering (name and identifier pairs) |
User & Place Events Listing
No template-specific variables. Uses only global variables.
User & Place Filter List
No template-specific variables. Uses only global variables.
Events RSS Feed
No template-specific variables. Uses only global variables.
Channels Templates
Channel Page Shell
| Variable | Type | Description |
|---|---|---|
is_community_page | Boolean | Whether this channel page is the platform’s community/social page |
is_homepage | Boolean | Whether this channel page is configured as the platform’s homepage |
featured_section_at_top | Boolean | Whether the featured events section renders above the main component columns |
Add Event Block
No template-specific variables. Uses only global variables.
Channel List
No template-specific variables. Uses only global variables.
Community List
No template-specific variables. Uses only global variables.
Department List
No template-specific variables. Uses only global variables.
Description
No template-specific variables. Uses only global variables.
Event List
| Variable | Type | Description |
|---|---|---|
component | Event List Component | The channel page component being rendered in this template |
Event Spotlight
No template-specific variables. Uses only global variables.
Filter Nav
| Variable | Type | Description |
|---|---|---|
component | Filter List Component | The channel page component being rendered in this template |
Group List
No template-specific variables. Uses only global variables.
Header
No template-specific variables. Uses only global variables.
Hero Image
No template-specific variables. Uses only global variables.
Google Map
No template-specific variables. Uses only global variables.
Month View Calendar
| Variable | Type | Description |
|---|---|---|
component | Month Calendar Component | The channel page component being rendered in this template |
Place List
No template-specific variables. Uses only global variables.
Platform Navigation
No template-specific variables. Uses only global variables.
RSS Feed
No template-specific variables. Uses only global variables.
Social Links
No template-specific variables. Uses only global variables.
Submit Event Button
No template-specific variables. Uses only global variables.
Event and Featured Tabs
No template-specific variables. Uses only global variables.
Website Link
No template-specific variables. Uses only global variables.
Groups Templates
Page Shell
| Variable | Type | Description |
|---|---|---|
num_members | Integer | Total number of members (followers) of this group |
Group Action Buttons
No template-specific variables. Uses only global variables.
Group Followers
| Variable | Type | Description |
|---|---|---|
num_members | Integer | Total number of members (followers) of this group |
User Follow Request Form
No template-specific variables. Uses only global variables.
Alert Message
No template-specific variables. Uses only global variables.
Users Templates
Public User Page Shell
| Variable | Type | Description |
|---|---|---|
top_places | Array of groups of up to 5 Place (with nil padding) | Places (Business) the user follows, up to 10, grouped into rows of five for layout |
num_friends | Integer | Total number of friends the user has on the platform |
top_friends | Array containing one inner Array of up to 4 User | A subset of the user’s friends for display on the profile page |
comments | Array | User’s comments |
show_map | Boolean | Business profiles only |
Dashboard Shell
| Variable | Type | Description |
|---|---|---|
achievements | Array | User achievements (each with label, status, URL, and CSS class) |
completion_percentage | Integer | Percent of onboarding checklist items completed (photo, invite friend, optional “follow a place”, complete profile) |
show_achievements | Boolean | Whether the onboarding checklist is shown because at least one checklist item is still incomplete |
num_needed_reviews | Integer | Number of past events the user attended but has not yet reviewed |
Dashboard Single Recent Activity Item
| Variable | Type | Description |
|---|---|---|
previous_feed_date | Date | Date of the previous feed page |
Dashboard Recent Activity List
| Variable | Type | Description |
|---|---|---|
num_needed_reviews | Integer | Number of past events the user attended but has not yet reviewed |
Dashboard Pending Submitted Event Item
No template-specific variables. Uses only global variables.
Dashboard Invitation Item
No template-specific variables. Uses only global variables.
Public User Page Action Buttons
| Variable | Type | Description |
|---|---|---|
relationship | Friendship relationship data | Current friendship status between the viewing user and profile user (friend, pending, blocked, etc.) |
Followers of Place
No template-specific variables. Uses only global variables.
Edit Profile
No template-specific variables. Uses only global variables.
Notification Settings
| Variable | Type | Description |
|---|---|---|
sms_notification_options | Array | SMS notification frequency options (label/value pairs) |
sms_notification_setting | Current setting | User’s current SMS notification preference |
Privacy Settings
| Variable | Type | Description |
|---|---|---|
privacy_options | Array | Privacy level options (label/value pairs) |
Bulletin Settings
No template-specific variables. Uses only global variables.
Calendar Digests
No template-specific variables. Uses only global variables.
Manage Friends & Places
| Variable | Type | Description |
|---|---|---|
current_tab | String | Which tab is currently selected (friends, places, or groups) |
friends | Array of UserFriend / UserFriend with business friendables / Group relation (depends on current_tab) | List of user’s friends, places they follow, or groups they follow depending on the active tab |
Manage Groups
No template-specific variables. Uses only global variables.
Friends & Places List
No template-specific variables. Uses only global variables.
Add Digest
| Variable | Type | Description |
|---|---|---|
filters | Hash | Filter options organized by filter category |
places | Array | Places for filter selection (label/value option list) |
groups | Array | Groups for filter selection (label/value option list) |
departments | Array | Departments for filter selection (label/value option list) |
day_names | Array of String (Sunday through Saturday) | Days of the week in order for digest scheduling |
match_options | Hash of String label to String value | Matching rule options (all events, any selected, etc.) for digest filtering |
Digest Edit
No template-specific variables. Uses only global variables.
Digest Form
No template-specific variables. Uses only global variables.
Digest Example Widget
No template-specific variables. Uses only global variables.
User Authentication Templates
User Login
No template-specific variables. Uses only global variables.
Access Denied
No template-specific variables. Uses only global variables.
Blocked Login Error
No template-specific variables. Uses only global variables.
Password Forgot Form
No template-specific variables. Uses only global variables.
Password Reset Form
| Variable | Type | Description |
|---|---|---|
successful | Boolean | Whether the password reset request was successfully submitted (shown after form POST) |
User Account Verification
No template-specific variables. Uses only global variables.
User Signup
| Variable | Type | Description |
|---|---|---|
errors | Array of String (human-readable error messages) | Validation error messages from a failed signup attempt |
errors_on | Array | Field names with errors (password, email, captcha) |
need_captcha | Boolean | Whether CAPTCHA verification is required on the signup form |
need_name | Boolean | Whether the name field is required on the signup form |
need_email | Boolean | Whether the email field is required on the signup form |
need_password | Boolean | Whether the password field is required (false when using SSO-only authentication) |
duplicate_email | Boolean | Set after form POST when email already exists |
captcha_error | Boolean | Set after form POST when CAPTCHA verification fails |
Message Management Templates
Page Shell
| Variable | Type | Description |
|---|---|---|
selected | String | The other participant in the open conversation, or nil when no thread is selected |
previous_page_url | String | In the message center: URL to load older messages in the open conversation, or false when there are no more to load |
no_selection | Boolean | Whether no conversation is currently selected in the message list |
compose_new_message | Boolean | Whether the compose-new-message form should be displayed |
can_compose_message | Boolean | Whether the current user has permission to send new messages |
Compose Form
No template-specific variables. Uses only global variables.
Conversation Thread
| Variable | Type | Description |
|---|---|---|
no_selection | Boolean | Whether no conversation is currently selected in the message list |
compose_new_message | Boolean | Whether the compose-new-message form should be displayed |
previous_page_url | String | In the message center: URL to load older messages in the open conversation, or false when there are no more to load |
Single Conversation Item
No template-specific variables. Uses only global variables.
User Contact Form
No template-specific variables. Uses only global variables.
Homepage Templates
Page Shell
| Variable | Type | Description |
|---|---|---|
event_groups | Array of Hash | Event groups (each with name, label, id, and events) |
has_default_group | Boolean | Whether an event group with “include in default” is contributing events to the default hot-events strip on this locality page |
department_list | Array | Departments with name and URL identifier |
filter_type_options | Hash | Filter options organized by filter category |
places | Array | Available places for filtering (name and identifier pairs) |
Right Sidebar Information Box
No template-specific variables. Uses only global variables.
Content Above Featured Tabs
No template-specific variables. Uses only global variables.
Trending List Tabs
No template-specific variables. Uses only global variables.
Right Sidebar
No template-specific variables. Uses only global variables.
Bulletin Templates
Subscription Form
| Variable | Type | Description |
|---|---|---|
email | String | The email address pre-filled in the subscription or unsubscription form |
name | String | The name pre-filled in the subscription form |
Subscription Confirmation
No template-specific variables. Uses only global variables.
Unsubscribe Form
| Variable | Type | Description |
|---|---|---|
email | String | The email address pre-filled in the subscription or unsubscription form |
Unsubscribe Confirmation
No template-specific variables. Uses only global variables.
Register Templates
Registrant Terms Page
No template-specific variables. Uses only global variables.
Registrant Terms Text
No template-specific variables. Uses only global variables.
Photo Management Templates
Page Shell
No template-specific variables. Uses only global variables.
Photo List
No template-specific variables. Uses only global variables.
Edit Form
| Variable | Type | Description |
|---|---|---|
recent_instances | Array | Recent events for photo association (label and event ID pairs) |
No Photo Selected
No template-specific variables. Uses only global variables.
Review Management Templates
Page Shell
No template-specific variables. Uses only global variables.
Review Form
No template-specific variables. Uses only global variables.
Review List
No template-specific variables. Uses only global variables.
Shared Among Multiple Views Templates
Event Item
No template-specific variables. Uses only global variables.
Featured Event Item
| Variable | Type | Description |
|---|---|---|
auto_play | String (‘true’/’false’) | Whether the featured-event rotation auto-advances by default. |
User Comment Item - Text
| Variable | Type | Description |
|---|---|---|
recent_activity | Parent activity owner | The user or activity whose comment is being displayed |
show_targets | Boolean | For recent activity: whether each item includes the related event or place (context) |
on | String context (optional) | The entity context this comment is attached to (event, place, group, etc.) |
User Comment Item - Review
| Variable | Type | Description |
|---|---|---|
show_targets | Boolean | For recent activity: whether each item includes the related event or place (context) |
on | String context (optional) | The entity context this comment is attached to (event, place, group, etc.) |
User Comment Item - Photo
| Variable | Type | Description |
|---|---|---|
show_targets | Boolean | For recent activity: whether each item includes the related event or place (context) |
on | String context (optional) | The entity context this comment is attached to (event, place, group, etc.) |
Alert Message
No template-specific variables. Uses only global variables.
Global Filter Selector
| Variable | Type | Description |
|---|---|---|
mode | String | Current view mode on unified search/calendar: “search”, “browse”, or “calendar”, depending on the current flow |
view_type | String | The current calendar view mode (e.g. month, week, day, upcoming) |
type | String | Content type being filtered (events, places, groups, departments) |
show_sort_options | Boolean | Whether the sort-order dropdown should be displayed |
distance_options | Array | Available distance filter options (label/value pairs) |
settings | Hash | Current filter state (within, near, hide_recurring) |
filter_options | Hash | Filter context to options data |
Mini Calendar
| Variable | Type | Description |
|---|---|---|
day | Date | Current date |
previous_month | Date | A date in the previous month, used to generate the navigation link |
next_month | Date | A date in the next month, used to generate the navigation link |
url_template | String | A URL pattern with a date placeholder, used to generate month navigation links |
title | String | The display title for the mini calendar widget (typically the month and year) |
Social Media Share Buttons
No template-specific variables. Uses only global variables.
Site Navigation - Before
No template-specific variables. Uses only global variables.
Site Navigation - After
No template-specific variables. Uses only global variables.
Load More Results Link
| Variable | Type | Description |
|---|---|---|
what | String | Type of items |
has_next_page | Boolean | Whether additional results exist beyond the current page |
next_page_url | String | URL to fetch the next page of results (used for AJAX pagination) |
mode | String | Current view mode on unified search/calendar: “search”, “browse”, or “calendar”, depending on the current flow |
div_id | String | DOM element ID |
Site Navigation
| Variable | Type | Description |
|---|---|---|
hide_add_button | Boolean | Optional, true when from channel page |
User Comment List
| Variable | Type | Description |
|---|---|---|
show_targets | Boolean | For recent activity: whether each item includes the related event or place (context) |
mode | String | Current view mode on unified search/calendar: “search”, “browse”, or “calendar”, depending on the current flow |
feedback_time_not_expired | Boolean | Whether the feedback submission window is still open for this event |
User Comment Form - Review
No template-specific variables. Uses only global variables.
Modals Templates
User Login
| Variable | Type | Description |
|---|---|---|
id_suffix | String | A unique suffix appended to HTML element IDs to prevent conflicts when multiple login modals exist on the same page |
Methods Shown at Login Prompt
No template-specific variables. Uses only global variables.
Message Shown at Login Prompt
No template-specific variables. Uses only global variables.
Edit Description
| Variable | Type | Description |
|---|---|---|
title | String | Modal heading text |
target | String | Form submission URL |
text | String | Current text content for the editor |
Widgets & Embedding Templates
Widget Builder Form
No template-specific variables. Uses only global variables.
Widget Builder Right Sidebar
No template-specific variables. Uses only global variables.
Related Articles
This article is part of a 9-part series on Localist developer theming:
- Introduction to Localist Developer Theming
- Site Configuration and Global Objects
- Events, Instances, and Related Objects
- Places, Groups, Departments, and Channels
- Shared Object Types
- Custom Liquid Tags Reference
- Custom Liquid Filters Reference
- Template Variable Reference
- Forms and User Management