Writing with the editor
Opening a post puts you in a full-screen editor, with the admin’s navigation out of the way. It is the Gutenberg block editor: your post is a stack of blocks, one per paragraph, heading, image, or list.
The layout
Section titled “The layout”The header holds, left to right: a back link, the block inserter, undo and redo, a list view toggle, the document name, the save state (Saved, Unsaved changes, or Saving), a preview width select, the save button, a Settings button that shows and hides the sidebar, and the publish button.
The title is its own field above the canvas, where blocks live. A breadcrumb at the bottom shows where in the block structure you stand.
The sidebar has two tabs: Document for status, slug, and excerpt, covered in Publishing, and Block for the selected block’s settings. A close button ends its tab row. On a screen 782 pixels wide or wider the sidebar starts open and slides in and out.
On a phone
Section titled “On a phone”On a screen narrower than 782 pixels the editor works like the WordPress editor on a phone:
- The editor fits the screen, so the page never scrolls sideways.
- The sidebar starts closed. Settings opens it over the writing area at the full width of the screen, and its close button puts it away.
- Undo, redo, the preview width select, the save state word, and the breadcrumb leave the screen. The save button names the state instead: Save draft, Saving, or Saved.
- The block toolbar sits in its own row above the title. Until you select a block, its buttons are greyed out.
- The list view opens over the writing area.
On a screen narrower than 600 pixels, Save draft shows as a cloud icon. At 600 pixels and narrower the document name leaves out the post type. At 403 pixels and narrower the document name leaves the header.
If the window narrows past 782 pixels while the sidebar is open, the sidebar closes, and it opens again when the window widens. A sidebar you closed yourself stays closed.
Working with blocks
Section titled “Working with blocks”The inserter (the plus button) opens a searchable library of blocks. The list view shows the post as a tree, the easiest way to move or select nested blocks. The preview select switches the canvas between Desktop, Tablet, and Mobile widths.
Undo and redo cover block edits only. The title, slug, excerpt, and status are outside that history.
The blocks you can use
Section titled “The blocks you can use”Paragraph, Heading, List, Quote, Pullquote, Code, Preformatted, Verse, Table, Image, Separator, Spacer, Group, Columns, Buttons, Details, Custom HTML, More, and Page Break, plus the structural blocks inside lists, columns, and buttons.
The Image block fills itself from the media library or from a web address.
Content using a block Gophenberg does not know still opens and saves. It shows as an unrecognized block and its markup is kept.
What reaches your site
Section titled “What reaches your site”Published content passes through an HTML filter that keeps
ordinary writing markup and removes active elements: scripts,
event handlers, iframes, forms, video, audio, and svg. Links are
limited to http, https, and mailto addresses.
The Custom HTML block accepts all of those in the editor, but they are dropped when the page is served. A pasted YouTube or Maps embed is an iframe, so it will not appear. If something is missing from your public site, this filter is usually why.