{"id":16357027,"date":"2023-05-19T19:55:55","date_gmt":"2023-05-19T19:55:55","guid":{"rendered":"https:\/\/wordpress.org\/documentation\/?post_type=helphub_article&#038;p=16357027"},"modified":"2026-05-27T03:35:30","modified_gmt":"2026-05-27T03:35:30","slug":"home-link-block","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/home-link-block\/","title":{"rendered":"Home Link block"},"content":{"rendered":"\n<p class=\"has-text-align-right has-small-font-size wp-block-paragraph\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/blocks\/\">Go to the list of Blocks<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The\u00a0Home Link\u00a0block allows you to automatically add a link to your site&#8217;s homepage. The\u00a0Home Link\u00a0block is only available as a sub-block of the\u00a0<a href=\"https:\/\/wordpress.org\/documentation\/article\/navigation-block\/\" data-type=\"helphub_article\" data-id=\"15191692\">Navigation<\/a>\u00a0block.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to add the Home Link block<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To add a\u00a0Home Link\u00a0block, you first need to add a\u00a0<a href=\"https:\/\/wordpress.org\/documentation\/article\/navigation-block\/\" data-type=\"helphub_article\" data-id=\"15191692\">Navigation<\/a>\u00a0block in a post or Site Editor. There are three ways you can use to add a\u00a0Home Link\u00a0block once you add a Navigation block:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>From the sidebar<\/li>\n\n\n\n<li>From the\u00a0Navigation\u00a0block contextual menu<\/li>\n\n\n\n<li>by converting an existing block<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">From the sidebar<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">With the\u00a0Navigation\u00a0block selected, click on the (<strong>+<\/strong>) icon in the sidebar, and either select the\u00a0Home link\u00a0block from the list of your recently used blocks or click on\u00a0Browse all\u00a0to show all the available blocks and select it from there.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/user-images.githubusercontent.com\/68744851\/232058336-08886952-5922-4bf4-ab6c-d50932c1e819.gif\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" src=\"https:\/\/user-images.githubusercontent.com\/68744851\/232058336-08886952-5922-4bf4-ab6c-d50932c1e819.gif\" alt=\"Adding the Home Link from the sidebar\" \/><\/a><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">From the Navigation Block <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">With the\u00a0Navigation\u00a0block selected, click on the (<strong>+<\/strong>) icon inside the\u00a0Navigation, and either select the\u00a0Home link\u00a0block from the list of your recently used blocks or click on\u00a0Browse all\u00a0to show all the available blocks and select it from there.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/user-images.githubusercontent.com\/68744851\/232063559-0d1d7d56-21db-4c04-87bd-f339e681096e.gif\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" src=\"https:\/\/user-images.githubusercontent.com\/68744851\/232063559-0d1d7d56-21db-4c04-87bd-f339e681096e.gif\" alt=\"Adding the Home Link from the Navigation Block \" \/><\/a><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">By converting an existing block<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Select an already-existing sub-block inside the\u00a0Navigation\u00a0block and click on the icon to the left of the\u00a0Drag\u00a0tool, which represents the actual sub-block. Select the\u00a0Home link\u00a0block from the drop-down menu.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/user-images.githubusercontent.com\/68744851\/232065572-0d6b6269-7fd6-436f-ba2a-c287245763f4.gif\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" src=\"https:\/\/user-images.githubusercontent.com\/68744851\/232065572-0d6b6269-7fd6-436f-ba2a-c287245763f4.gif\" alt=\"Adding the Home Link by converting an existing block\" \/><\/a><\/figure>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/adding-a-new-block\/\">Detailed instructions on adding blocks<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block toolbar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Each block has its own toolbar, which contains unique controls that let you customize or configure the block. The\u00a0Home Link\u00a0block has the following options on its toolbar:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"308\" height=\"57\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.44.25-PM.png\" alt=\"Block toolbar for the home link block\" class=\"wp-image-16357030\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.44.25-PM.png 308w, https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.44.25-PM-300x56.png 300w\" sizes=\"auto, (max-width: 308px) 100vw, 308px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Transform to<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"331\" height=\"156\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.45.31-PM.png\" alt=\"Transform toolbar for the home link block\" class=\"wp-image-16357031\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.45.31-PM.png 331w, https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.45.31-PM-300x141.png 300w\" sizes=\"auto, (max-width: 331px) 100vw, 331px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">You can transform your\u00a0Home Link block\u00a0to a <a href=\"https:\/\/wordpress.org\/documentation\/article\/custom-link-block\/\" data-type=\"helphub_article\" data-id=\"16278661\">Custom Link<\/a> block.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Block moving tools<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"308\" height=\"57\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.44.25-PM-1.png\" alt=\"Block moving tools for the home link block\" class=\"wp-image-16357032\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.44.25-PM-1.png 308w, https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.44.25-PM-1-300x56.png 300w\" sizes=\"auto, (max-width: 308px) 100vw, 308px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">You can reorder\u00a0Home Link block\u00a0inside a\u00a0Navigation\u00a0block. Use the toolbar to\u00a0move\u00a0the items\u00a0left and right or\u00a0drag\u00a0them to a new position.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Text formatting<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Basic\u00a0Text formatting\u00a0is available for all\u00a0Home Link\u00a0blocks. Select your title (or a part of it) to make it\u00a0Bold, Italic, or\u00a0Strikethrough, or turn it into an\u00a0Inline image\u00a0to cover your link with an image.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"260\" height=\"159\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/05\/Screenshot-2023-05-19-at-12.50.04-PM.png\" alt=\"Block text formatting for the home link block\" class=\"wp-image-16357033\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">More options<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The\u00a0Options\u00a0section opens block settings and a button to move to the\u00a0parent Navigation field\u00a0section to update it. You can also\u00a0copy, duplicate, lock, or\u00a0remove your Home Link.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\">Learn more about\u00a0More options settings<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Each link has its\u00a0Block settings\u00a0you can access by clicking the\u00a0settings\u00a0button on the upper-right corner of the editor or via\u00a0Options\u00a0in the toolbar.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Typography<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The\u00a0Home Link\u00a0block provides typography settings to change the font family, appearance, line height, letter spacing, decoration, letter case, and font size.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\">For details refer to this support article:&nbsp;<a href=\"https:\/\/wordpress.org\/documentation\/article\/typography-settings-overview\/\">Typography settings overview<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading has-medium-font-size\">Dimensions<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The<strong> <\/strong>Home Link\u00a0block provides dimension settings options to width.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\">For details refer to this support article: <a href=\"https:\/\/wordpress.org\/documentation\/article\/dimension-controls-overview\/\">Dimension settings overview<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Home Link block provides the following Advanced settings options: HTML anchor, Additional CSS Class(es), Additional CSS, and Styles.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/advanced-settings-overview\/\">Learn more about advanced settings<\/a><\/p>\n\n\n\n<div id=\"changelog\" class=\"wp-block-group changelog has-background is-layout-flow wp-block-group-is-layout-flow\" style=\"background-color:#dce5ec\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Changelog<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Updated 2026-05-26 (props to @kjoyner @awetz583)\n<ul class=\"wp-block-list\">\n<li>Removed bold and italics <\/li>\n\n\n\n<li>Converted paragraph labels to headings <\/li>\n\n\n\n<li>Updated &#8220;Advanced&#8221; section to refer to new overview page<\/li>\n\n\n\n<li>Style links to overview pages to be consistent<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Created 2023-05-19<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Go to the list of Blocks The\u00a0Home Link\u00a0block allows you to automatically add a link to your site&#8217;s homepage. The\u00a0Home Link\u00a0block is only available as a sub-block of the\u00a0Navigation\u00a0block. How to add the Home Link block To add a\u00a0Home Link\u00a0block, you first need to add a\u00a0Navigation\u00a0block in a post or Site Editor. There are three [&hellip;]<\/p>\n","protected":false},"author":14322318,"featured_media":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false},"category":[80,91],"class_list":["post-16357027","helphub_article","type-helphub_article","status-publish","hentry","category-customization","category-theme-blocks"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16357027","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles"}],"about":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/types\/helphub_article"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/users\/14322318"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16357027"}],"version-history":[{"count":10,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16357027\/revisions"}],"predecessor-version":[{"id":16368615,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16357027\/revisions\/16368615"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16357027"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16357027"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}