Document {{#social_accounts}} block helper

[ErisDS]

Summary

Documents the new {{#social_accounts}} block helper (added in TryGhost/Ghost#27834 and now shipped). The helper iterates the connected social accounts on a given source object — typically @site or an author — replacing ~27 lines of repetitive {{#if twitter}}…{{#if facebook}}… blocks in theme templates with a single iterator, while keeping themes in full control of markup, classes, and icon partials.

{{#social_accounts @site}}
    <a href="{{href}}" target="_blank" rel="noopener" aria-label="{{name}}">
        {{> (concat "icons/" type)}}
    </a>
{{/social_accounts}}

Changes

• themes/helpers/data/social_accounts.mdx — New page. Covers the explicit-source design, four usage examples (@site, inside {{#foreach authors}}, on author pages, with {{else}}), the per-iteration attributes (type, href, username, name), the supported platform list, and a short rationale for why the source must be explicit.
• themes/helpers/data.mdx — Adds a row for social_accounts to the data helpers index table, immediately above social_url.
• docs.json — Adds the new page to the Data helpers nav, alphabetised next to social_url.
• themes/helpers/data/social_url.mdx — Adds a one-line cross-link pointing readers at {{#social_accounts}} for the "render all connected platforms at once" use case. (Held back from Fix social_url helper fallback documentation #61 to avoid an in-flight conflict; included here now that Fix social_url helper fallback documentation #61 has merged.)

Companion / related

• ✨ Added {{#social_accounts}} block helper for theme social rendering Ghost#27834 — the helper PR (merged & shipped)
• Added social_accounts to v6 knownHelpers gscan#802 — adds social_accounts to gscan's knownHelpers
• Fix social_url helper fallback documentation #61 — {{social_url}} fallback documentation fix (merged)

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Ghost	🟢 Ready	View Preview	May 13, 2026, 10:15 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5a494d3b-6585-41b2-bcaf-7568718ac2af

📥 Commits

Reviewing files that changed from the base of the PR and between 1244668 and dd5209b.

📒 Files selected for processing (1)

• themes/helpers/data/social_accounts.mdx

---

Walkthrough

Adds a new MDX reference page for the {{#social_accounts}} block helper (frontmatter, description, per-iteration variables, iteration frame variables, usage examples for sitewide and author contexts, else behavior, and supported platforms). Updates the Data Helpers reference table to include a social_accounts row and inserts the new route into docs navigation. Adds a cross-reference from the social_url helper page to the social_accounts helper.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

• TryGhost/Docs#61: Updates social_url helper documentation and is directly related to the cross-reference added to social_accounts.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: documenting the new {{#social_accounts}} block helper, which is the primary focus of all changes in the PR.
Description check	✅ Passed	The description provides detailed context about the new helper, explains the changes made, includes usage examples, and references related work. It is comprehensive and directly related to the changeset.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/social-accounts-helper

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@themes/helpers/data/social_url.mdx`:
- Line 15: The PR added a cross-link mentioning `{{`#social_accounts`}}` but the
PR objectives stated that this link should be deferred to avoid conflict with PR
`#61`; either remove the new cross-link sentence referencing `social_accounts`
from the content or update the PR objective/note to state that the
`social_accounts` cross-link will be included now, ensuring the change in intent
is reflected in the PR description and release notes; locate the added text that
contains `{{`#social_accounts`}}` and either delete that sentence or rewrite the
PR metadata to match the new plan.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 16042669-7d5c-4c0a-a48c-2d759c3db303

📥 Commits

Reviewing files that changed from the base of the PR and between 0e3674a and c979233.

📒 Files selected for processing (4)

• docs.json
• themes/helpers/data.mdx
• themes/helpers/data/social_accounts.mdx
• themes/helpers/data/social_url.mdx