Skip to content

docs: clarify CMS binding in MCP custom code #492

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tristan-mouchet merged 1 commit into from
Aug 13, 2026
Merged

docs: clarify CMS binding in MCP custom code #492

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion lib/mcp/instructions.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -652,7 +652,15 @@ automatically); never raw HTML or plain text expecting formatting.
page_id_target = the dynamic page, and NO collection_item_id — it resolves per item.

Show/hide ANY layer conditionally (sale badges, empty states) with set_layer_visibility —
same condition model as set_collection_filters.`,
same condition model as set_collection_filters.

**Dynamic-page SEO vs custom code (different binding syntaxes):**
- SEO title/description: bind fields with \`<ycode-inline-variable>\` tags (same as set_dynamic_text).
- Custom code head/body: bind fields with \`{{FieldName}}\` placeholders (exact collection field
names). Image/file fields resolve to their URL; use \`{{Reference.NestedField}}\` for references.
NEVER put \`<ycode-inline-variable>\` in custom code — tokens are printed literally and break
JSON-LD. Example JSON-LD in custom_code.head:
\`<script type="application/ld+json">{"@context":"https://schema.org","@type":"BlogPosting","headline":"{{Name}}","image":"{{Cover Image}}"}</script>\``,

localization: `### Locales & Translations — Detailed Guide

Expand Down
16 changes: 10 additions & 6 deletions lib/mcp/tools/pages.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,22 +125,26 @@ DRAFT STATUS: Set is_publishable to false to keep the page as a draft that is sk
'update_page_settings',
`Update page SEO, custom code, password protection, or CMS binding (dynamic pages).

SEO: Set title, description, noindex, and OG image (asset ID).
Custom code: Inject HTML into <head> or before </body>.
SEO: Set title, description, noindex, and OG image (asset ID). On dynamic pages, bind CMS
fields in title/description with <ycode-inline-variable> tags (same format as set_dynamic_text).
Custom code: Inject HTML into <head> or before </body>. On dynamic pages, bind CMS fields
with {{FieldName}} placeholders (exact collection field names) — NOT <ycode-inline-variable>.
Use this for per-item JSON-LD (BlogPosting, BreadcrumbList, etc.). Image/file fields resolve
to their URL; references support {{Reference.NestedField}}.
Password protection: Enable/disable with a password.
CMS binding: For dynamic pages — bind to a collection, pick the slug field, and configure
how next-item / previous-item links traverse the collection.`,
{
page_id: z.string().describe('The page ID'),
seo: z.object({
title: z.string().optional().describe('SEO title (appears in browser tab and search results)'),
description: z.string().optional().describe('SEO meta description'),
title: z.string().optional().describe('SEO title (appears in browser tab and search results). On dynamic pages, bind fields with <ycode-inline-variable> tags — not {{FieldName}}.'),
description: z.string().optional().describe('SEO meta description. On dynamic pages, bind fields with <ycode-inline-variable> tags — not {{FieldName}}.'),
noindex: z.boolean().optional().describe('Prevent search engines from indexing this page'),
image_asset_id: z.string().nullable().optional().describe('OG image asset ID for social sharing'),
}).optional(),
custom_code: z.object({
head: z.string().optional().describe('HTML to inject into <head> (e.g. analytics scripts)'),
body: z.string().optional().describe('HTML to inject before </body>'),
head: z.string().optional().describe('HTML to inject into <head> (analytics, JSON-LD, meta tags). On dynamic pages use {{FieldName}} for CMS values — never <ycode-inline-variable>.'),
body: z.string().optional().describe('HTML to inject before </body>. On dynamic pages use {{FieldName}} for CMS values — never <ycode-inline-variable>.'),
}).optional(),
auth: z.object({
enabled: z.boolean().describe('Enable or disable password protection'),
Expand Down