social_url

Usage: {{social_url type="platform"}} (e.g., {{social_url type="facebook"}}, {{social_url type="bluesky"}})

---

The {{social_url}} helper generates a URL for a specified social media platform based on the provided platform type. It takes a single argument, type, which specifies the social media platform (e.g., facebook, mastodon, etc.).

When called inside an author scope (e.g. {{#author}} or {{#foreach authors}}), the helper looks up the platform on the current author first, then falls back to the sitewide value from @site. Outside an author scope, it reads directly from @site. If neither has a value, the helper outputs nothing.

Supported platforms: facebook, twitter, linkedin, threads, bluesky, mastodon, tiktok, youtube, instagram. All nine are configurable both per-author (Staff > [user]) and sitewide (Settings > General > Social accounts).

To render a row of icons for every connected platform on a single object, see {{#social_accounts}}.

Examples

Output the author’s Threads URL, using an author block:

{{#author}}
  {{#if threads}}<a href="{{social_url type="threads"}}">Follow me on Threads</a>{{/if}}
{{/author}}

All platforms can be accessed sitewide via @site:

{{#if @site.twitter}}<a href="{{social_url type="twitter"}}">Follow us on X</a>{{/if}}
{{#if @site.bluesky}}<a href="{{social_url type="bluesky"}}">Follow us on Bluesky</a>{{/if}}
{{#if @site.linkedin}}<a href="{{social_url type="linkedin"}}">Follow us on LinkedIn</a>{{/if}}