NextPress documentation

Block reference

Every block type with its name in the API, the SDK helper that builds it, and the group it belongs to.

On this page

Each block has a type name, used when you read or write blocks through the SDK, the MCP server or the API. In code, build a block with the helper on nextpress.blocks. Where the table shows fromName, call nextpress.blocks.fromName("<name>"). For what each block looks like, see Blocks overview.

Basic

LabelNameSDK helper
Headingcore/headingheading
Paragraphcore/paragraphparagraph
Buttoncore/buttonbutton, or submitButton for a form's send button
Buttonscore/buttonsbuttons
Iconcore/iconicon
Badgecore/badgefromName

Form fields

LabelNameSDK helper
Formcore/formform
Text fieldcore/inputinput
Text areacore/textareatextarea
Dropdowncore/selectselect

form() with no children starts with a name, an email and a message field and a send button. Pass children to use your own fields.

Media

LabelNameSDK helper
Imagecore/imageimage
Gallerycore/gallerygallery
Videocore/videovideo
Audiocore/audioaudio
Media & Textcore/media-textmediaText
Covercore/covercover
Filecore/filefile
Logo cloudcore/logo-cloudfromName

Layout

LabelNameSDK helper
Spacercore/spacerspacer
Separatorcore/separatorseparator
Dividercore/dividerdivider
Columnscore/columnscolumns
Containercore/containercontainer
Groupcore/groupgroup
Stackcore/stackfromName
Headercore/headerfromName
Accordion, Accordion itemcore/accordion, core/accordion-itemfromName
Popupcore/popupfromName
Gridcore/gridfromName
Cardcore/cardfromName
Steps, Stepcore/steps, core/stepfromName
Tabs, Tabcore/tabs, core/tabfromName
Templatecore/template-partfromName, with content {"templateId": "<id>"}

Divider is not shown in the editor's block list but is still accepted.

Advanced

LabelNameSDK helper
Quotecore/quotequote
Listcore/listlist
Codecore/codecode
Custom HTMLcore/htmlhtml
Pullquotecore/pullquotepullquote
Preformattedcore/preformattedpreformatted
Tablecore/tabletable
Markdowncore/markdownmarkdown
Searchcore/searchfromName

Post

LabelNameSDK helper
Post Titlepost/titlepostTitle
Post Excerptpost/excerptpostExcerpt
Featured Imagepost/featured-imagepostFeaturedImage
Post Listpost/listpostList
Table of Contentspost/tocpostToc
Author Boxpost/author-boxpostAuthorBox
Post Commentspost/commentspostComments
Post Navigationpost/navigationpostNavigation
Post Infopost/infopostInfo
Reading Progresspost/progresspostProgress
Post bodypost/bodyfromName

Other helpers

  • nextpress.blocks.starterLayout() returns a heading and a paragraph for an empty page.
  • nextpress.blocks.custom() builds a plugin or custom block by name.
  • nextpress.blocks.names lists every block name. nextpress.blocks.isBlockName() checks one.

Rules

  • Some blocks belong inside another: form fields inside a Form, accordion items inside an Accordion, steps inside Steps, tabs inside Tabs.
  • A template has one layout block at its outer level: Group, Stack, Columns, Container, Header, Accordion, Popup or Form.
  • Every block is checked when it is saved. An invalid block is refused with the reason.

Next steps