Add Custom Social Links to a Ghost Theme
Ghost supports social accounts for publications and staff profiles. Available networks include Facebook, X/Twitter, LinkedIn, Threads, and Bluesky. They also include Mastodon, TikTok, YouTube, and Instagram. For publication links, use Settings → General → Social accounts. For an author’s links, open their staff profile. Then render the links with Ghost’s social_url or social_accounts helper.
For a network Ghost does not support, use Custom Settings to add a field to the admin and expose its value to the theme. This keeps the link editable without changing theme files each time.
Custom Settings supports five field types: select, boolean, color, image, and text. This example uses text fields for Dribbble and a public email address.
In the theme package.json file under the config key, add the following:
"custom": {
"dribbble_page": {
"type": "text",
"default": ""
},
"email": {
"type": "text",
"default": ""
}
}
Upload the theme to your website. The new fields appear at Settings → Site → Design & branding → Customize → Theme → Site wide.
Use the @custom object to access each field’s value in your theme file. Place it where you want the value to appear. I will use the #if helper to check if there is a value and then output that value.
{{#if @custom.dribbble_page}}
<a href='{{ @custom.dribbble_page }}'>Dribbble</a>
{{/if}}
{{#if @custom.email}}
<a href='mailto:{{ @custom.email }}'>{{ @custom.email }}</a>
{{/if}}
Use a descriptive setting name and check any URL before adding it to the theme.
This post began as a forum answer about social accounts. It was updated after Ghost added more built-in social accounts.
More from the Blog
Latest Ghost Themes
Arish
For visual magazines that lead with photography, film, and selected stories.
Siwa
A personal publication that introduces the writer before inviting readers into the stories.
Hanoi
An image-led magazine for creative stories, rich navigation, and long-form reading.
Taba
A newsroom front page for coverage across topics, video, and story formats.
Marsa
A flexible publication homepage for featured stories, topics, and newsletters.
Hakone
For writers who want readers to browse complete posts on the homepage.