{"id":16358117,"date":"2023-08-08T10:00:00","date_gmt":"2023-08-08T10:00:00","guid":{"rendered":"https:\/\/wordpress.org\/documentation\/?post_type=helphub_article&#038;p=16358117"},"modified":"2026-05-25T13:15:36","modified_gmt":"2026-05-25T13:15:36","slug":"details-block","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/details-block\/","title":{"rendered":"Details 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 Details block displays a text summary and an arrow button: When you click on the text or the button, the block opens and reveals additional content on the page.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This block provides a way to show or hide content on your site. This can be useful on faq pages, showing \/hiding detailed event information etc.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The<strong> <\/strong>Summary is customizable by selecting the &#8220;Write summary&#8230;&#8221; placeholder text and adding your own text. By default, the block uses the summary content as its label, similar to how the Heading block works.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The additional content blocks that you place inside the Details block that are hidden until you click on the summary text or the button. Because the content is hidden until you open the block, it is referred to as &#8220;hidden content&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"540\" style=\"aspect-ratio: 960 \/ 540;\" width=\"960\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/details-summary-name-6.8.mp4\"><\/video><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Closed state:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"266\" height=\"104\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-summary-closed.png\" alt=\"The details block is closed and the icon in the arrow button points towards the summary text.\" class=\"wp-image-16358145\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Open state:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"868\" height=\"210\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-summary-open.png\" alt=\"The details block is open and the arrow icon points towards the content  below the summary,\" class=\"wp-image-16358146\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-summary-open.png 868w, https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-summary-open-300x73.png 300w, https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-summary-open-768x186.png 768w\" sizes=\"auto, (max-width: 868px) 100vw, 868px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Add a Details block<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To add a Details block, click on the <strong>Block Inserter<\/strong> (+)&nbsp; and select the Details block.<br>You can also type <kbd>\/details<\/kbd> and hit <kbd>enter<\/kbd> in a new paragraph block to add one quickly.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"648\" height=\"320\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-details-slash-inserter.png\" alt=\"Using the slash inserter to type \/details\" class=\"wp-image-16358149\" style=\"width:680px;height:336px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-details-slash-inserter.png 648w, https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-details-slash-inserter-300x148.png 300w\" sizes=\"auto, (max-width: 648px) 100vw, 648px\" \/><figcaption class=\"wp-element-caption\">Using the slash inserter<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1544\" style=\"aspect-ratio: 3022 \/ 1544;\" width=\"3022\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/details-block.mov\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Block toolbar<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Every block comes with unique toolbar icons and block-specific user controls that allow you to manipulate the block right in the editor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Details block shows five buttons in the block toolbar:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Transform to<\/li>\n\n\n\n<li>Drag icon<\/li>\n\n\n\n<li>Move arrows<\/li>\n\n\n\n<li>Change alignment<\/li>\n\n\n\n<li>More rich text controls<\/li>\n\n\n\n<li>More options<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"606\" height=\"104\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-block-toolbar.png\" alt=\"block toolbar\" class=\"wp-image-16366473\" style=\"aspect-ratio:5.827648384673178;width:442px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-block-toolbar.png 606w, https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-block-toolbar-300x51.png 300w\" sizes=\"auto, (max-width: 606px) 100vw, 606px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Transform to<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"688\" height=\"400\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-transform-menu.png\" alt=\"block toolbar transform menu \" class=\"wp-image-16366474\" style=\"aspect-ratio:1.7200281260986758;object-fit:cover;width:500px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-transform-menu.png 688w, https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-transform-menu-300x174.png 300w\" sizes=\"auto, (max-width: 688px) 100vw, 688px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Click on the transform button to place the block inside a group or columns block.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Drag<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"704\" height=\"242\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-drag-.png\" alt=\"block toolbar drag handles\" class=\"wp-image-16366475\" style=\"aspect-ratio:2.909214179634532;width:500px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-drag-.png 704w, https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-drag--300x103.png 300w\" sizes=\"auto, (max-width: 704px) 100vw, 704px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">To drag and drop the block to a new location on the page template, click and hold the rectangle of dots, then drag to the new location. The blue separator line indicates where the block will be placed. Release the left mouse button when you find the new location to place the block.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Move<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"476\" height=\"230\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-move.png\" alt=\"block toolbar move arrows\" class=\"wp-image-16366476\" style=\"width:400px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-move.png 476w, https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-move-300x145.png 300w\" sizes=\"auto, (max-width: 476px) 100vw, 476px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The up and down arrow icons can be used to move the block up and down on the page.<\/p>\n\n\n\n<p class=\"has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/site-logo-block\/\">Get more information about moving a block within the Editor.<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Change alignment<\/h3>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"738\" height=\"462\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-alignment.png\" alt=\"block toolbar alignment options\" class=\"wp-image-16366477\" style=\"width:500px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-alignment.png 738w, https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Details-alignment-300x188.png 300w\" sizes=\"auto, (max-width: 738px) 100vw, 738px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Change the alignment of the block to none, wide, or full width.<\/p>\n\n\n\n<h3 id=\"more-rich-text-options\" class=\"wp-block-heading\">More rich text options<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The drop-down menu to the left of the&nbsp;<a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\">More options menu<\/a>&nbsp;contains a range of additional rich text editing options such as highlighting, inline code, strikethrough, and more.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-text-editing-overview\/\">Read about more rich text editing options.<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">More options<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The <a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\">More Options menu<\/a> represented by three vertical dots on the far right of the toolbar gives you more features such as the ability to duplicate or remove your block.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\">Read about these and other settings.<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Block settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The block settings panel contains customization options specific to the block. To open it, select the block and click the Settings button next to the Publish or Save button.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"628\" height=\"890\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Screenshot-2026-02-17-at-4.10.31-PM.png\" alt=\"The Details block settings sidebar.\" class=\"wp-image-16366752\" style=\"width:320px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Screenshot-2026-02-17-at-4.10.31-PM.png 628w, https:\/\/wordpress.org\/documentation\/files\/2023\/08\/Screenshot-2026-02-17-at-4.10.31-PM-212x300.png 212w\" sizes=\"auto, (max-width: 628px) 100vw, 628px\" \/><\/figure>\n\n\n\n<div style=\"height:21px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Open by default<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Enabling this option keeps the block open and the hidden content will be disaplay until closed.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Details block provides the following Advanced settings options: HTML anchor, Additional CSS Class(es), Name attribute, Styles, and Allowed blocks.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use the <strong>Name attribute<\/strong> setting to group related Details blocks together. Details blocks with the same name attribute work like an accordion: opening one closes the others in that group.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, if <strong>Summary 1<\/strong> and <strong>Summary 2<\/strong> both use the name attribute <code>faq<\/code>, opening one will close the other. If <strong>Summary 3<\/strong> uses a different name attribute, it will open and close independently.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Leave this field blank if you want each Details block to open and close on its own.<\/p>\n\n\n\n<p class=\"has-text-align-left 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<h2 class=\"wp-block-heading\">Styles<\/h2>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"279\" height=\"657\" src=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-details-sidebar-styles.png\" alt=\"The styles tab in the Details block settings sidebar.\" class=\"wp-image-16358189\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-details-sidebar-styles.png 279w, https:\/\/wordpress.org\/documentation\/files\/2023\/07\/63-details-sidebar-styles-127x300.png 127w\" sizes=\"auto, (max-width: 279px) 100vw, 279px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Color<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The block provides dimension settings options to add text, background, and link color.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/colors-settings-overview\/\">See this guide for more information about changing colors.<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Typography<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The block 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-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a href=\"https:\/\/wordpress.org\/documentation\/article\/typography-settings-overview\/\">Get more details about changing typography settings.<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Dimensions<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The<strong> <\/strong>block provides dimension settings options to add padding and margin.<\/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\">Border<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The block provides border settings options to add border color, style, width, and radius.<\/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\/border-settings-overview\/\">Border settings overview<\/a><\/p>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\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-large-font-size\">Changelog<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Updated 2026-05-25 (props @kjoyner @awetz583)\n<ul class=\"wp-block-list\">\n<li>Updated &#8220;Advanced&#8221; section to refer to new overview page<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>2026-02-17 (props to @awetz583)\n<ul class=\"wp-block-list\">\n<li>Added heading for add a block<\/li>\n\n\n\n<li>Updated advanced screenshots and added information for Manage allowed blocks setting<\/li>\n\n\n\n<li>Updated heading case and size<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>2025-12-02\n<ul class=\"wp-block-list\">\n<li>Added rich text options for 6.9. Props @annezazu.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>2024-07-05\n<ul class=\"wp-block-list\">\n<li>Added name attribute in advanced settings for 6.8<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>2024-06-13 Updated video to 6.5 version<\/li>\n\n\n\n<li>2023-12-05 Headings case resolved<\/li>\n\n\n\n<li>Created 2023-08-08<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Go to the list of Blocks The Details block displays a text summary and an arrow button: When you click on the text or the button, the block opens and reveals additional content on the page. This block provides a way to show or hide content on your site. This can be useful on faq [&hellip;]<\/p>\n","protected":false},"author":634001,"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,85],"class_list":["post-16358117","helphub_article","type-helphub_article","status-publish","hentry","category-customization","category-text-blocks"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16358117","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\/634001"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16358117"}],"version-history":[{"count":78,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16358117\/revisions"}],"predecessor-version":[{"id":16368507,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16358117\/revisions\/16368507"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16358117"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16358117"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}