Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Info

WordPress Button Settings Explained: What Each Option Does

WordPress Button Settings Explained: What Each Option Does

Short answer

WordPress button settings live in the Button block and its parent Buttons block. Each button controls its link, style, colours, typography, padding, border and width, while the parent container controls justification, orientation, wrapping and spacing for the whole group.

Key takeaways

  • Each Button sits inside a parent Buttons container block.
  • Link, colour, border and width belong to the single button.
  • Alignment and spacing belong to the Buttons container.
  • Use sponsored or nofollow rel values for paid and untrusted links.
  • Change all buttons at once in Styles in the Site Editor.

What are the WordPress button settings?

WordPress button settings are the options in the Buttons block that control the link, style, colour, size, width, border, spacing and alignment of each button, plus advanced options like CSS classes and anchors.

In the block editor, a button always sits inside a Buttons block, which is a container. Each button inside it is a separate Button block with its own settings.

That split explains a lot of confusion. Alignment and layout live on the parent Buttons block, while colour, border and link live on each single Button.

The official Buttons block documentation covers the basics. This guide explains what each option actually does and when to use it.

If you have not added a button yet, start with how to create a button in WordPress.

Where do you find button settings in WordPress?

You find button settings by selecting a Button block in the editor, then using the block toolbar above it and the Settings sidebar on the right, which has Settings and Styles tabs.

  1. Open the post or page in the block editor.
  2. Click the button text to select the single Button block.
  3. Use the floating toolbar for the link, bold, italic and alignment tools.
  4. Open the sidebar with the Settings icon in the top right if it is hidden.
  5. Switch between the Settings and Styles tabs to see every option.

To select the parent container instead, click the Select parent block icon on the toolbar, or use the List View to pick Buttons.

The exact layout of the sidebar changes a little between WordPress versions, but the options themselves stay much the same.

Link settings set where the button goes, whether it opens in a new tab, and which rel attributes it carries, such as nofollow or sponsored, for SEO and security.

  • Link sets the URL. Click the link icon in the toolbar, paste a URL or search for a page on your site.
  • Open in new tab adds target blank to the link. Use it sparingly, mainly for external resources.
  • Link rel lets you add values such as nofollow, sponsored or ugc.

The rel values tell search engines how you relate to the linked page. Google explains when to use each one in its guide to qualifying outbound links.

For a technical view of what each rel value means, MDN has a clear reference on the rel attribute.

Affiliate and paid links should use sponsored. Links to sites you do not want to vouch for can use nofollow.

What do the button style options do?

The style options switch a button between Fill, which has a solid background colour, and Outline, which shows only a border with a transparent background, giving you a primary and secondary look.

You find these under the Styles tab, in the Styles section at the top.

Fill is the default and works best for your main call to action. Outline suits secondary actions, like Learn more next to a Buy now button.

Some themes register extra button styles. If you see more options than Fill and Outline, they come from your theme or a plugin.

How do button colour settings work?

Colour settings let you set the button text colour and background colour, or a gradient background, using your theme palette or a custom colour picker.

Open the Styles tab and find the Color panel. Click Text or Background to choose a colour.

Theme palette colours are safer than custom ones. If you change your palette later, buttons using palette colours update automatically.

Check contrast between text and background. Low contrast makes buttons hard to read and can fail accessibility guidelines.

Our guide on how to change button color in WordPress covers hover colours and site-wide changes in more depth.

What do typography and dimension settings do?

Typography settings control the font size, font family, weight, line height and letter case of the button text, while dimension settings control padding inside the button.

These options sit in the Typography and Dimensions panels of the Styles tab. Some are hidden by default, so click the three-dot menu on each panel to show more controls.

Padding is what makes a button feel bigger or smaller. More padding gives a larger click target, which helps on mobile.

If an option is missing, your theme may have turned it off. Block themes control which settings appear through their theme.json file.

How do border and radius settings change a button?

Border settings add a border with a chosen colour, width and style, and the radius setting rounds the corners, from fully square to a pill shape.

Find these in the Border panel. You can link all four corners or set each corner separately.

A large radius gives a soft, pill-shaped button. A radius of zero gives sharp corners that suit more formal designs.

Outline buttons rely on the border, so check its width and colour when you use that style.

What does the button width setting do?

The width setting sets a button to 25, 50, 75 or 100 percent of the width of its parent container, which is useful for full-width mobile buttons or evenly sized button groups.

Find it in the Settings tab under Width settings. If no width is chosen, the button sizes itself to its text.

Equal widths look tidy when two or three buttons sit side by side. Full width suits single calls to action in narrow columns.

Which settings belong to the Buttons container?

The parent Buttons block controls layout for the whole group, including justification, orientation, wrapping, block spacing between buttons and overall alignment.

SettingWhere it livesWhat it controls
Link, new tab, relSingle ButtonWhere the button goes
Fill or OutlineSingle ButtonSolid or bordered look
Colour and gradientSingle ButtonText and background colours
TypographySingle ButtonFont size, weight, case
PaddingSingle ButtonSize of the clickable area
Border and radiusSingle ButtonEdge and corner shape
WidthSingle ButtonPercent of the container
JustificationButtons containerLeft, centre, right, space between
OrientationButtons containerHorizontal or vertical stacking
Wrapping and spacingButtons containerLine wrap and gaps between buttons

If a button will not centre, you probably have the single Button selected instead of the container. Our guide on how to center a button in WordPress explains the fix.

What are the advanced button settings?

The Advanced panel lets you add an HTML anchor so other links can jump to the button, and extra CSS classes so you can style the button with your own CSS.

Open the Settings tab and expand Advanced at the bottom.

Use an HTML anchor if you want a link elsewhere on the page to scroll to this button. Use Additional CSS class(es) to target the button with custom CSS from Appearance > Customize > Additional CSS or the Site Editor.

The core blocks reference lists the attributes and supports each core block has, including the Button block.

How do you change button settings across the whole site?

To change all buttons at once in a block theme, go to Appearance > Editor > Styles and edit the Button block or the Buttons element, so every button inherits the new defaults.

In the Site Editor, open Styles, then Blocks, and choose Button. Changes there apply to every button that has not been styled individually.

Buttons with their own colours or borders keep those settings. Clear the individual styles if you want them to follow the global defaults.

Theme developers can set button styles in theme.json. The global settings and styles guide explains how.

Classic themes usually handle button styling through the Customizer or theme options instead. For general edits to an existing button, see how to edit a button in WordPress.

Frequently asked questions

Why can I not see some button settings in WordPress?

Some panels hide less common options behind a three-dot menu, so click it to show more controls. Block themes can also turn settings off in their theme.json file, and older WordPress versions may not have newer options.

How do I make a WordPress button open in a new tab?

Select the button, click the link icon in the toolbar, and switch on the option to open in a new tab. Use this mainly for external resources so visitors do not lose your page.

How do I add nofollow to a WordPress button?

Select the Button block, open the Settings tab, and look for the link rel field under Advanced or the link settings. Type nofollow, or sponsored for paid and affiliate links, then update the page.

What is the difference between Fill and Outline buttons?

Fill buttons have a solid background colour and suit main calls to action. Outline buttons have a transparent background with a visible border, so they work well for secondary actions placed next to a filled button.

Can I change every button on my site at once?

Yes, in block themes. Open the Site Editor, go to Styles, then Blocks, and edit the Button block. Every button without its own custom styling will follow the new colours, typography and borders.

Sources

  1. Buttons block WordPress.org
  2. Core Blocks Reference WordPress Developer Resources
  3. Global Settings and Styles WordPress Developer Resources
  4. Qualify your outbound links to Google Google Search Central
  5. HTML attribute: rel MDN Web Docs

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.