NewThe WP Tutoring WordPress training platform is live — on demand video courses and interactive WordPress lessons. Free lessons included.Start free
Helping site owners learn WordPress since 2012 · (844) WP-TUTOR
Block Editor

Adding a Button in Gutenberg (the Block Editor)

Add a call-to-action button in the WordPress block editor: insert the Buttons block, write the label, link it, and style it — step by step.

WT
WP Tutoring TeamWordPress Instructors
Updated Aug 5, 2026
2 min read
Table of contents

A clear button is the easiest way to move readers to the thing you want them to do next — sign up, download, get in touch. The block editor has a dedicated Buttons block, and it takes about a minute to use well.

Re-shot in August 2026 on WordPress 7.0 — the screenshots match the current editor.

TL;DR The 30-second version
  • Insert the Buttons block, type your label, and link it with the toolbar's link icon.
  • Fill vs Outline and colors live in the Styles tab of the sidebar.
  • Width presets (25–100%) are under Settings.
  • One page, one primary button: fewer, clearer calls to action convert better.
Insert the Buttons block

In the editor, click the blue + in the top-left corner, search for buttons, and click the Buttons block. It arrives with one empty button ready for text.

Searching for the Buttons block in the block inserter

Write the label

Click inside the button and type what it should say. Keep it short and action-shaped: "Download the Free Manual" beats "Click here."

A Button block with its label typed and the toolbar showing

Link it

With the button selected, click the link icon in the toolbar, paste or type the destination URL, and press Enter. You can also start typing a page title from your own site and pick it from the suggestions. In the link options you'll find Open in new tab if you need it.

Style it

Open the settings sidebar and switch to the Styles tab (the half-circle icon). Here you choose Fill (solid) or Outline, set text and background colors, and adjust typography. Under the Settings tab there's a Width control with 25% / 50% / 75% / 100% presets if you want the button wider than its text.

The Button block's Styles tab with Fill and Outline options

Publish and test

Click Publish (or Update), open the live page, and actually click your button. Thirty seconds of testing catches the classic mistakes — a typo'd URL or a link to a draft page.

Alignment trick

To center a button, select the outer Buttons container (not the inner button) and use the justification control in its toolbar — the same control that left- or right-aligns a whole row of buttons.

Keep learning

Frequently asked questions

What's the difference between the Buttons block and the Button block?
Buttons (plural) is the container row; each Button (singular) lives inside it. You insert Buttons, and it starts you off with one Button. Add more buttons to the same row with the + that appears next to an existing one.
How do I make a WordPress button open in a new tab?
Select the button, click the link icon in its toolbar, and after setting the URL expand the link's options and enable "Open in new tab." Use it sparingly — same-tab navigation is the friendlier default for links on your own site.
Why does my button look different on the live site?
Your theme controls the default button design. The editor shows a close preview, but the exact font, radius, and colors come from the theme's styles — check the live page after publishing, and adjust colors in the block's Styles tab if needed.
WT

WP Tutoring Team

WordPress Instructors

We’ve been teaching WordPress to individuals and businesses since 2013 — through step-by-step tutorials, video courses, and 1-on-1 tutoring sessions.

Leave a comment

Comments are reviewed before they appear.

Get our free WordPress starter guide

Join thousands of site owners and get step-by-step WordPress tutorials in your inbox, plus printable cheat sheets.

Beginner-friendly, no jargon
Printable cheat sheets & checklists
Unsubscribe anytime

Request your session

We’ll reply quickly — usually the same business day.

By using this form you agree with the storage and handling of your data by this site.

Access our WordPress Training Academy videos

Step-by-step video courses covering the block editor, themes, plugins, and everything you need to build a site you’re proud of. Free lessons included — browse the full library before you sign up for anything.

Explore the Academy