Chykalophia Docs
WordPress

The most useful blocks, explained

A plain-English guide to the WordPress blocks you'll use most often — what each one does and when to use it.

Difficulty
Beginner

WordPress comes with dozens of built-in blocks. You don't need to know all of them — but knowing the most useful ones will make editing your site much faster and more confident. This guide introduces the blocks you'll reach for every time.

Quick summary

The blocks you'll use most are: Paragraph, Heading, Image, List, Buttons, Quote, Video, Table, Spacer, and Columns. Each one does exactly what its name suggests. Click the + button in the editor to find and add any of them.

Text blocks

Paragraph

The Paragraph block is the default block — it's what you get when you just start typing. Use it for body text. Keep paragraphs short (3–4 sentences) for easier reading.

You can bold, italicize, or add a link using the small toolbar that appears above the block when you click on it. The toolbar's drop-down menu has extra options such as highlighting, and more styling settings (like font size and colors) are in the block settings on the right.

Heading

Use Heading blocks to organize your content into sections. WordPress uses heading levels numbered 1 through 6:

Heading levelWhen to use it
H1The main page title — only one per page, usually set automatically
H2Major section headings on the page
H3Sub-sections within an H2 section
H4–H6Rarely needed; use sparingly for deeply nested content

Don't skip heading levels

For accessibility and SEO, headings should follow a logical order — H2, then H3, then H4. Don't jump from H2 to H4. Screen readers use headings to navigate a page, so keeping them in order helps all your readers.

List

Use the List block for bullet points or numbered lists. In the block toolbar, you can switch between an Unordered list (bullets) and an Ordered list (numbers). Hit Enter to add a new list item, and Tab to indent a sub-item.

Quote

The Quote block is for highlighting a standout sentence — a testimonial, a notable statement, or a key insight. It usually renders with visual styling (like a large quotation mark or indentation) set by your theme.

Classic

The Classic block embeds the older WordPress editor. You may see it in older content. For new content, use the modern blocks instead — they're more flexible and easier to style.


Media blocks

Image

The Image block lets you add a single photo or graphic to your content. You can:

  • Upload a new image from your computer
  • Choose one from the media library
  • Paste an image URL

Always fill in the Alternative text field in the right-hand panel. Alt text describes the image for people using screen readers and helps search engines understand what the image shows. See adding images to a page or post for the full walkthrough.

The Gallery block displays multiple images in a grid. You can choose how many columns to use. It's ideal for portfolios, before-and-after photos, or product shots.

Video

The Video block is for uploading a video file directly to your site. For videos hosted on YouTube or Vimeo, use the YouTube or Vimeo embed blocks instead — the video stays on YouTube or Vimeo, so it doesn't use your hosting storage. (If you paste a YouTube link into a Video block, WordPress switches it to a YouTube embed for you.) See how to embed a video.

File

The File block adds a downloadable file (like a PDF or a brochure) with a download button. Upload the file and the block creates the link automatically.


Layout blocks

Buttons

The Buttons block adds one or more call-to-action buttons. Each button has a label and a link URL. Each button can use the Fill or Outline style, and your theme may add more. Buttons are one of the most important blocks on a page — they guide visitors to take the next step.

Columns

The Columns block divides your content into side-by-side sections. You start by picking a layout (such as 50 / 50 or 33 / 66), and you can change the number of columns (1 to 6) later in the block settings. You can put any block inside each column. This is useful for comparing features, showing a team grid, or creating a two-column text-and-image layout.

Group

The Group block wraps other blocks together into a single unit. This is useful when you want to give a section a background color, add padding, or move several blocks as one piece.

Separator

The Separator block adds a horizontal line between sections. Use it sparingly to create a visual break without a heading.

Spacer

The Spacer block adds empty vertical space between blocks. Drag the handle at the bottom of the spacer, or use the Height setting, to adjust it. This is often better than pressing Enter multiple times to add space.


Embed blocks

YouTube

Paste a YouTube video URL into the YouTube block and the video embeds directly in the page. Visitors can play it without leaving your site. Much better than uploading video directly to WordPress.

Vimeo

Same as the YouTube block, but for Vimeo-hosted videos. Works the same way — paste the URL and the video appears.


Data blocks

Table

The Table block creates a grid of rows and columns. It's great for pricing comparisons, schedules, or any structured information. Use Edit table in the block toolbar to add or remove rows and columns.


Blocks at a glance

Everyday content

  • Paragraph — body text
  • Heading — section titles
  • List — bullet or numbered lists
  • Image — photos and graphics
  • Buttons — call-to-action links
  • Quote — highlighted statements

Layout and media

  • Columns — side-by-side content
  • Gallery — image grids
  • Video / YouTube / Vimeo — video embeds
  • File — downloadable documents
  • Table — structured data
  • Spacer — breathing room between sections

Common questions

I need a block that isn't in this list — can I get more blocks?

Yes. Many plugins add extra blocks — for example, WooCommerce adds product blocks, and form plugins add form blocks. You can also install block library plugins. Ask your project lead if you need a specific type of block your site doesn't currently have.

Can I search for a block instead of scrolling through the list?

Yes. Click the + button to open the Block Inserter, then type the name of the block in the search field. You can also type / followed by the block name on an empty line in your content.

How do I change a block type after I've added it?

Click the block, then click the icon at the far left of the floating toolbar. It shows the icon of the current block type, and WordPress's documentation calls it Transform to. A menu appears with compatible block types you can switch to. For example, you can convert a Paragraph block to a Heading.

What's the difference between the Image block and the Cover block?

The Image block displays an image inline with your content. The Cover block uses an image (or a color or video) as a background and lets you overlay text on top of it — often used for headers and section banners. The Cover block is for decorative backgrounds; the Image block is for content images.

Need a hand?

If you're stuck, email support@chykalophia.com and we'll help. Include your website address and a screenshot if you can.

Learn more

Last updated

On this page