Skip to content

Theme Development

Syngency website themes are built using Liquid templates, standard HTML, CSS, and JavaScript. Templates are managed per-agency in Websites > Templates and rendered server-side when a page is requested.

Each template has a different set of Liquid objects available. Review the Template Variables introduction for a reference of all objects available in each template context. Global objects / variables are available in all contexts.

TIP

Building themes with simple structure, common frameworks and libraries, and descriptive {% comment %} usage for customizations enables easier future maintenance for the Syngency support team and is encouraged.

Website file structure

Layouts

NameDescription
MasterThe root HTML document. Wraps all page templates — typically contains <head>, global nav, and footer. Refer to the Master template guide.

Templates

NameURLDescription
Home/Agency home page
Divisions/divisionsList of all divisions
Division/divisions/[division-slug]A single division and its talent roster
Model/divisions/[division-slug]/portfolios/[model-slug]Individual talent/model profile
Model Submission/apply or /submissionPublic talent submission form
Package/packages/[package-token]A shared model package
Page/pages/[page-slug]A custom static page
Posts/[post-category-slug]Post listing, with URL based on the post category
Post/[post-category-slug]/[post-slug]A single post
Search/searchSearch results
Castings/castingsPublic casting call page
Not Found (404)404 error page

Locales

Where the agency is configured for multi-language, this section includes the corresponding locale JSON files (e.g. en.json, fr.json), for custom definition of translatable strings to be used in the website templates. See the t Liquid filter for more information.

Snippets

Reusable partial templates that can be included in any layout or template using the render tag.

Assets

Static files uploaded for use by agency's website templates, PDF templates, email signatures etc. Theme CSS, JavaScript, fonts, and images, served via the Syngnecy CDN and included in templates with the asset_url Liquid filter.

liquid
<link rel="stylesheet" href="{{ 'agency-style.css' | asset_url }}">
<meta property="og:image" content="{{ 'og-image.png' | asset_url }}">

Other templates

PDF, document and email templates can be edited via Settings > Templates. Assets uploaded under Website > Templates are also available to these templates using the asset_url Liquid filter - useful for logos, custom fonts etc.