Skip to content

docs: clarify CMS binding in MCP custom code - #492

Merged
tristan-mouchet merged 1 commit into
developfrom
docs/mcp-custom-code-cms-binding
Aug 13, 2026
Merged

docs: clarify CMS binding in MCP custom code#492
tristan-mouchet merged 1 commit into
developfrom
docs/mcp-custom-code-cms-binding

Conversation

@tristan-mouchet

Copy link
Copy Markdown
Collaborator

Summary

Document the correct way to bind CMS fields in page custom code via MCP, so agents stop putting <ycode-inline-variable> tokens in JSON-LD (which are not interpolated and produce invalid structured data).

Changes

  • Document {{FieldName}} placeholders for custom code head/body on dynamic pages
  • Contrast with <ycode-inline-variable> used for SEO title/description
  • Add a JSON-LD example in the CMS deferred guide
  • Update update_page_settings tool and field descriptions

Test plan

  • Ask an MCP agent to add BlogPosting JSON-LD on a dynamic CMS page
  • Confirm it uses {{FieldName}} in custom_code.head, not <ycode-inline-variable>
  • Publish and verify Rich Results Test parses the structured data

Agents were reusing <ycode-inline-variable> in custom code head,
which is not interpolated and breaks per-item JSON-LD. Document
{{FieldName}} for custom code vs inline variables for SEO.
@tristan-mouchet tristan-mouchet added the Documentation Improvements or additions to documentation label Aug 11, 2026
@tristan-mouchet tristan-mouchet self-assigned this Aug 11, 2026
@tristan-mouchet
tristan-mouchet merged commit ea557b7 into develop Aug 13, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant