A concise guide to structuring article content so it conforms to a given JSON Schema, with practical examples and best practices.
How to organize titles, leads, paragraphs, SEO fields, categories, and sources to produce JSON-schema-compliant article data.
Why schema compliance matters
Using a JSON Schema to validate article data ensures consistent structure, prevents missing fields, and makes content ingestible by downstream systems like CMSs and search engines.
Required top-level fields
Ensure your article object includes the required properties (title, lead, description, paragraphs, seo, categories, sources). Omitting any required field will cause validation to fail.
Paragraph formatting
Each paragraph must provide a content string. Optionally include a title for clarity. Do not add extra properties per paragraph beyond title and content if the schema disallows them.
SEO, categories, and sources
Provide at least one SEO metatag and an SEO description, at least one numeric category ID, and at least one valid HTTP(S) source URL. These fields help with indexing, classification, and traceability.