Title: Custom Link block
Author: Leonardus Nugraha
Published: December 11, 2022
Last modified: May 25, 2026

---

# Custom Link block

## In this article

 * [Block toolbar](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#block-toolbar)
    - [Transform to](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#transform-to)
    - [Block moving tools](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#block-moving-tools)
    - [Link tool](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#link-tool)
    - [Adding submenu to a Custom Link block](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#adding-submenu-to-a-custom-link-block)
    - [Text formatting](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#text-formatting)
    - [More options](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#more-options)
 * [Block settings](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#block-settings)
    - [Link settings](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#link-settings)
    - [Typography](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#typography)
    - [Advanced](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#advanced)
 * [Changelog](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#changelog)

[ Back to top](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#wp--skip-link--target)

[Go back to the list of **Blocks**](https://wordpress.org/documentation/article/blocks/)

The Custom Link block allows you to embed a link, page, category, or another item
in your Navigation section. 

![WordPress editor block: Add link window with typed URL, toolbar, and options for
updating the link.](https://wordpress.org/documentation/files/2022/12/image4-3.png)

To add a Custom Link block, you must first add the Navigation block by clicking 
the **Block inserter** (+) icon or typing `/navigation` in the editor.

![The plus icon in the toolbar and the Navigation block selection option to add 
a Custom link block](https://wordpress.org/documentation/files/2022/12/image8-3.
png)

The Add link field will appear after adding a Navigation block. Type your URL or
select from recent pages you used or created on WordPress. Hit enter to save the
link. 

![URL pasted to the Custom Link block with option to select other items and the 
toolbar above.](https://wordpress.org/documentation/files/2022/12/adding-custom-
link.gif)

You can insert multiple Custom Link blocks in one** Navigation **section. Hit enter
after editing one link, and a new Add link field will appear. Every Custom Link 
block can have a separate link and text settings.

![One Custom Link block selected, Bold and Italics text formatting applied to it,
and Options section expanded to click Duplicate.](https://wordpress.org/documentation/
files/2022/12/customizing-custom-link.gif)

Detailed instructions on adding blocks can be found [here](https://wordpress.org/documentation/article/adding-a-new-block/).

## 󠀁[Block toolbar](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#block-toolbar)󠁿

Each block has its own toolbar, which contains unique controls that let you customize
or configure the block. The _Custom Link_ block has the following options on its
toolbar:

### 󠀁[Transform to](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#transform-to)󠁿

You can transform your Custom Link block to:

 * Submenu, turning your link into a wrapped links list
 * [Spacer](https://wordpress.org/documentation/article/spacer-block/) for dividing
   multiple links with an empty block
 * [Search](https://wordpress.org/documentation/article/search-block/), creating
   a search bar 
 * Home link, linking to homepage of your website
 * [Site logo](https://wordpress.org/documentation/article/site-logo-block/) for
   adding your site logo
 * [Social icons](https://wordpress.org/documentation/article/social-icons/) for
   embedding buttons that lead to a selected social media platform

![Custom Link block editor toolbar with the selected ‘Transform to’ icon and unwrapped
options for updates.](https://wordpress.org/documentation/files/2022/12/image13-
2.png)

### 󠀁[Block moving tools](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#block-moving-tools)󠁿

You can reorder Custom Link blocks inside a **Navigation** section. Use the toolbar
to move the items left and right or drag them to a new position. 

![Two toolbars with the Move option and example of a Custom Link block and with 
the Drag tool featured with three blocks.](https://wordpress.org/documentation/files/
2022/12/image7-1.png)

For more information, explore the [Navigation block](https://wordpress.org/documentation/article/navigation-block/).

### 󠀁[Link tool](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#link-tool)󠁿

The **Link** tool lets you edit your custom link block. You can edit title and custom
URL and decide whether you want to open the link in a new tab.

![The toolbar with a Custom Link block editing process containing typing a title,
selecting to open in a new tab, and demonstrating the unlink option.](https://wordpress.
org/documentation/files/2022/12/editing-custom-link.gof_.gif)

### 󠀁[Adding submenu to a Custom Link block](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#adding-submenu-to-a-custom-link-block)󠁿

The next icon lets you build a submenu, where you can add links to a drop-down list.

![WordPress editor Submenu section in the Navigation block applied to the selected
Custom Link with the options to type URL or select an item.](https://wordpress.org/
documentation/files/2022/12/image11-1.png)

### 󠀁[Text formatting](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#text-formatting)󠁿

Basic **Text formatting** is available for all Custom Link blocks. Select your title(
or a part of it) to make it Bold, Italic, or Strikethrough, or turn it into an Inline
image to cover your link with an illustration.

![WordPress Custom Link block toolbar with selected text formation and additional
options unwrapped, followed by the edited block example.](https://wordpress.org/
documentation/files/2022/12/image9-1.png)

### 󠀁[More options](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#more-options)󠁿

The **Options **section opens block settings and a button to move to the parent 
Navigation field section to update it. You can also copy, duplicate, lock, or remove
your Custom Link. Like everywhere in the WordPress editor, you can undo actions 
using the **Ctrl+Z** (or **Command+Z** on macOS).

Details about **More options** can be found in this [support article](https://wordpress.org/documentation/article/more-options/).

## 󠀁[Block settings](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#block-settings)󠁿

Each link has its **Block settings** you can access by clicking the **settings **
button on the upper-right corner of the editor or via **Options **in the toolbar.

### 󠀁[Link settings](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#link-settings)󠁿

**Link settings** section contains the following options:

 * **Description** to display with your link if the selected theme includes that
   option.
 * **Link title **to provide more information about the link for search engine optimization.
   Leave this field empty if you want the title used in URL settings to stay. 
 * **Link rel** to specify how your external link is related to the page you’re 
   working on and if its authority should be higher than your website’s. 

Refer to the [Navigation block documentation](https://wordpress.com/support/full-site-editing/theme-blocks/navigation-block/#link-settings)
for more information.

### 󠀁[Typography](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#typography)󠁿

The Custom Link block provides typography settings to change the font family, appearance,
line height, letter spacing, decoration, letter case, and font size.

For details refer to this support article: [Typography settings overview](https://wordpress.org/documentation/article/typography-settings-overview/)

### 󠀁[Advanced](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#advanced)󠁿

The Custom Link block provides the following Advanced settings options: HTML anchor,
Additional CSS Class(es), Additional CSS, and Styles.

[Learn more about advanced settings](https://wordpress.org/documentation/article/advanced-settings-overview/)

## 󠀁[Changelog](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#changelog)󠁿

 * Updated 2026-05-25 (props @kjoyner @awetz583)
    - Updated “Advanced” section to refer to new overview page
 * 2023-07-25
    - Fix broken image URLs
 * Created 2022-12-11

## Was this article helpful? How could it be improved? 󠀁[Cancel reply](https://wordpress.org/documentation/article/custom-link-block/?output_format=md#respond)󠁿

[Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Fcustom-link-block%2F&locale=en_US).
If you need support with something that wasn't covered by this article, please post
your question in the [support forums](https://wordpress.org/support/forums/).

First published

December 11, 2022

Last updated

May 25, 2026