Every change to the protocol is additive: a receiver built for an older version keeps working, and ignores fields
it doesn't know. ping still answers protocol: 1; the minor versions below are the packages' versions.
1.8: image dimensions (November 2026)
- An image may carry its
widthandheightin whole pixels: as attributes on the<img>incontentHtmland aswidth/heightnumbers on theimageblock incontentBlocks, each only when the article has one. Keep them on the<img>.article.listitems may report them the same way, and an import keeps them; a percentage or a style still makes the article read-only in Sei. @getsei/webhook1.8.0: theSeiImageBlocktype.@getsei/payload1.6.0 keeps them aswidthandheighton theseiImageblock.- WordPress: images with
width/heightattributes (classic content, andcore/imageblocks as WordPress up to 6.2 saved a resized image) import editable and publish back the same; the plugin is unchanged. An image resized in WordPress 6.3+ (astyle) is still read-only.
1.7: tables (November 2026)
- An article body can hold a table:
<table>incontentHtml(a header row in<thead>with<th>cells, the other rows in<tbody>), and{ type: "table", header, rows }incontentBlocks, each cell a text run. Skip a block type you don't know;contentHtmlalways has the whole body. article.listitems may report tables the same way, and an import keeps them. Merged cells, captions, a header column or styles make the article read-only in Sei.@getsei/webhook1.7.0: theSeiTableBlocktype.@getsei/payload1.5.0 keeps tables as Lexical tables when the content field hasEXPERIMENTAL_TableFeature, and as one paragraph per row otherwise.- WordPress: Sei imports and publishes
core/tableblocks (fixed layout, no caption); the plugin is unchanged.
1.6: social title and description, and pages (October 2026)
article.social: { title, description }on a full publish of an article that has them: the shared link's title and description when they differ from the SEO ones. Print them asog:title/og:description(and Twitter) tags, falling back toseoTitleandmetaDescriptionfor an empty one. Absent: leave them as they are.@getsei/webhook1.6.0 validates it.@getsei/payload1.4.0 stores them assei.ogTitleandsei.ogDescription.- The WordPress plugin (1.2) prints Open Graph and Twitter tags when no SEO plugin does, and copies the social title and description into Yoast, Rank Math, SEOPress or The SEO Framework.
- Pages: a receiver that keeps pages too answers ping with the
pagescapability. Sei then imports and publishes them withkind: "page"on the article, and onarticle.unpublish,article.deleteandarticle.restore;article.listitems that are pages carrykind: "page".@getsei/payload1.4.0: thepagesoption.
1.5: publish dates (October 2026)
publishedAtin the publish reply and inarticle.listitems: when the article first went live, ornull. Sei orders its Articles list's live articles by it, as the site lists them.@getsei/webhook1.5.0: the types.
1.4: preview (October 2026)
article.previewwith thepreviewcapability: the site renders the draft like a published article at a short-lived URL on its own host, and answers{ url }. Sei shows that page as the editor's Preview.@getsei/webhook1.4.0:onPreview.@getsei/payload1.4.0: thepreview: { url(doc, token) }option andgetSeiPreview(payload, token), so a Payload site's own article page renders the draft.- Sei's preview badge links to the site's own preview URL ("Open on your site"), where the page's scripts run.
1.3: cover image (October 2026)
article.featuredImage: { url, alt }on every full publish of an article with a cover. Absent: keep the article's image.article.listitems may reportfeaturedImage, and an import sets the cover in Sei.@getsei/webhook1.3.0 validates it.@getsei/payload1.3.0 addsfields.featuredImage(a text field, or an upload field it downloads into once) andfields.featuredImageAlt.
1.2: delete and restore (October 2026)
article.deleteandarticle.restore, with thedeleteandrestorecapabilities.- The receiver decides how to delete and answers
recoverable. @getsei/webhook1.2.0:onDelete,onRestore.@getsei/payload1.2.0: thedeleteoption (deletes for good by default, keeps the document with{ field }, never withfalse).
1.1: categories and tags (October 2026)
article.categoriesandarticle.tagson every full publish (possibly empty: remove them all; absent: an older Sei, keep them).terms.listand thetaxonomiescapability.@getsei/payload1.1.0: thetaxonomiesoption.
1.0 (October 2026)
ping,article.publish(publish, draft, schedule;ifRevision,seoOnly,asNew),article.unpublish,article.list, signed as Standard Webhooks.