Block Editor Last updated May 2026 The Block Editor offers a variety of blocks that can be used to create content in Pages and Posts. Different blocks create different kinds of content but also layout, such as into a grid or columns. For standard content that you want to edited with a rich text editor toolbar that works similarly to a word processor, we recommend the Classic block. On this page: Getting Started with Blocks Recommended Block Types Text Blocks Word Processor Editor Experience Tables Media Blocks Images Audio and Video Media & Text Files Cover Design Blocks Accordions / Hide-Reveal Buttons Separator Page Layout Options Widget Blocks Anchors for Linking to Another Spot on the Page Learn More Getting Started with Blocks Make sure you are familiar with the editor screen. To add a block, place your cursor in the content area workspace where you’d like the content to appear and click the Add Block button or the Block Inserter button from the top toolbar. (If you’re more familiar with the shortcuts, you can type the forward slash (/) and the shortcut for the block you want to insert). This will bring up a list of all available blocks. The blocks are organized by type, and you can hover over each one for a description. Just drag the block to the workspace and start typing. There’s a lot of options, please see the recommended blocks below. If it’s not already displayed, be sure to click to see the Settings Sidebar where you’ll find settings for the specific Block you are working with. Recommended Block Types Text Blocks Blocks like Heading, Paragraph and List are self-explanatory. There are also blocks that are formatted for quotes and verses. Each block has a toolbar to manage style and alignment. Word Processor Editor Experience The Classic block provides and editing experience that has a rich text editor toolbar and works similarly to a word processor with buttons that allow you to format text, change alignment, inert lists, links and images, and more. Tables One of two ways to insert tabular data on your site. Instructions for this block can be found on our Tabular Data page. Media Blocks Remember best practices for website accessibility and optimization when using media. Image and Gallery A singular image can be inserted into a page as an inline image in a Paragraph block or a standalone image using an Image block. For multiple images, you can insert a Gallery block. Learn more about inserting images and galleries. Audio and Video For audio and video, you can either upload your media to the media library or stream content from an external service. Learn more about inserting video and audio and adding media from external sites. Media & Text Allows you to place an image or video side-by-side with text. You can also make the image a link. Files Currently, the only file type you’re able to attach in WordPress is .pdf (Portable Document Format; Adobe Acrobat). If you need to use another file type, you can always upload it to Box and link to the file or contact us for more options. Learn more about documents and attachments and creating accessible PDF files. Cover Lets you add a background color, image or video with a text overlay. It’s a great way to add headers, banner-style displays, call-to-actions, and more. If using a background color or image, you need to make sure the color contrast passes accessibility requirements. Design Blocks You can add design elements like buttons, horizontal rules, and arrange blocks in various configurations. Accordions / Hide-Reveal Creates a hide-reveal accordion with content that allows visitors to click on a trigger to reveal or disclose additional content on the page. Buttons You can customize the text, link, and style of the button. You can change the text and button colors in the block settings panel. To add more buttons to the block, click the Add block button in the bottom right corner. Please make sure the color contrast passes accessibility requirements. Separator Inserts a horizontal line between two blocks of content to help create a separation between ideas or sections on your post or page. Page Layout Options Blocks like Columns, Grids and Spacer give you multiple ways to present information on your page. Learn about the different options on Page Layout Options. Widget Blocks Add widgets to your page or post like social media icons, custom HTML code or a list of your post categories or latest posts. Anchors for Linking to Another Spot on the Page Linking to specific spots within a page can be useful on long pages with multiple sections. When someone clicks a link with to an “anchor”, the browser will load the page as close to the content as possible at the top of the screen. In the Advanced settings for most blocks, you have the ability to create anchors. Enter a word or two in the HTML Anchor field. The text value of each anchor must be unique within the page. It must start with a letter and is case-sensitive. It cannot include a space but can include the following symbols: hyphen(-) or underscore(_). Read the section about how to format a link with an anchor on the general Anchor Links page. Links with an anchor are added the same as any other link. Learn More More detailed information about the Block Editor and Anchor Links can be found on the WordPress documentation site.
