{"id":16369393,"date":"2026-07-08T21:37:06","date_gmt":"2026-07-08T21:37:06","guid":{"rendered":"https:\/\/wordpress.org\/documentation\/?post_type=helphub_article&#038;p=16369393"},"modified":"2026-07-08T23:08:46","modified_gmt":"2026-07-08T23:08:46","slug":"date-block","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/date-block\/","title":{"rendered":"Date 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\">Use the Date block to display a custom date.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor.jpg\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"534\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor-1024x534.jpg\" alt=\"Editor view of the date block set to a custom date of January 1, 2026\" class=\"wp-image-16369400\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor-1024x534.jpg 1024w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor-300x156.jpg 300w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor-768x400.jpg 768w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor-1536x800.jpg 1536w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-editor-2048x1067.jpg 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Add a Date block<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To add the Date block, click the&nbsp;<strong>+ Block Inserter<\/strong>&nbsp;button in the top-left corner of the editor. Search for the Image block and click on the block to add it to the page.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"566\" height=\"640\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-slash.png\" alt=\"Add a date block with a slash command\" class=\"wp-image-16369397\" style=\"width:308px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-slash.png 566w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-slash-265x300.png 265w\" sizes=\"auto, (max-width: 566px) 100vw, 566px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">You can also quickly add the Date block by typing&nbsp;<code>\/date<\/code>&nbsp;and pressing&nbsp;<strong>Enter<\/strong>.<\/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\/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<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"544\" height=\"120\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar.png\" alt=\"Date b;pcl tpp;bar\" class=\"wp-image-16369402\" style=\"width:325px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar.png 544w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-300x66.png 300w\" sizes=\"auto, (max-width: 544px) 100vw, 544px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">To view the block toolbar, click on the block and the toolbar will be displayed.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Transform<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"662\" height=\"578\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-transforms.png\" alt=\"Date block transforms\" class=\"wp-image-16369396\" style=\"aspect-ratio:1.14536799707067;width:367px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-transforms.png 662w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-transforms-300x262.png 300w\" sizes=\"auto, (max-width: 662px) 100vw, 662px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Click on the <strong>Transform<\/strong> button to convert the Date block into a Post Date, Modified Date, Group, Columns or Details block.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You will also see a &#8220;This block is connected&#8221; message indicating that the block has a binding to the Post&#8217;s published date.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Block moving tools<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"544\" height=\"120\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-move.png\" alt=\"Block moving tools\" class=\"wp-image-16369403\" style=\"width:325px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-move.png 544w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-move-300x66.png 300w\" sizes=\"auto, (max-width: 544px) 100vw, 544px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The block-moving tools allow you to move the block in the editor. Use the <strong>six dots icon<\/strong> to drag and drop the&nbsp;block and place it anywhere on the page. Alternatively, click on the <strong>up and down arrows<\/strong> to move the block up or down.<\/p>\n\n\n\n<p class=\"has-text-align-left has-background wp-block-paragraph\" style=\"background-color:#e5f5fa\"><a rel=\"noreferrer noopener\" href=\"https:\/\/wordpress.org\/documentation\/article\/moving-blocks\/\" target=\"_blank\">Get more information about moving a block within the editor.<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Change text alignment<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"544\" height=\"120\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-align.png\" alt=\"Block toolbar align\" class=\"wp-image-16369405\" style=\"width:325px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-align.png 544w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-toolbar-align-300x66.png 300w\" sizes=\"auto, (max-width: 544px) 100vw, 544px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Click the <strong>Change alignment<\/strong> button in the Block toolbar to display the alignment drop-down. You can align the block text to the left, make it center-aligned or align it to the right.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Change date<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"499\" height=\"1024\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-edit-date-499x1024.png\" alt=\"Block toolbar change date display\" class=\"wp-image-16369406\" style=\"width:309px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-edit-date-499x1024.png 499w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-edit-date-146x300.png 146w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/date-block-edit-date.png 558w\" sizes=\"auto, (max-width: 499px) 100vw, 499px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Click the <strong>Change date<\/strong> button in the Block toolbar to display a modal with date settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can select a custom date and time through the input fields and options or select the date from the calendar. You can use the arrow buttons or drop down box to select a different month.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Click anywhere outside the modal, press the <kbd>Escape<\/kbd> key, or click on the button with the X to close the modal.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">More options <\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>More options<\/strong> menu represented by three vertical dots on the far right of the toolbar gives you more features such as the ability to duplicate or remove the 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<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"442\" height=\"112\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/block-settings-button-7-0.png\" alt=\"Block settings button\" class=\"wp-image-16369330\" style=\"aspect-ratio:3.946839681875262;width:322px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/block-settings-button-7-0.png 442w, https:\/\/wordpress.org\/documentation\/files\/2022\/03\/block-settings-button-7-0-300x76.png 300w\" sizes=\"auto, (max-width: 442px) 100vw, 442px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Every block has specific options in the editor sidebar in addition to the options found in the block toolbar.&nbsp;If you do not see the sidebar, click on the&nbsp;<strong>Settings <\/strong>button&nbsp;next to the Save\/Publish button.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Transform to variation button<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Date block can be easily transformed into a <a href=\"https:\/\/wordpress.org\/documentation\/article\/post-date-block\/\" data-type=\"helphub_article\" data-id=\"16357811\">Post Date<\/a> or <a href=\"https:\/\/wordpress.org\/documentation\/article\/post-modified-date-block\/\">Modified Date<\/a> block either by choosing the Transform button on the block toolbar or the <strong>Transform to variation<\/strong> button from the block settings.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"556\" height=\"764\" src=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/Screenshot-2026-07-08-at-4.36.03-PM.png\" alt=\"Transform to a variation button\" class=\"wp-image-16369407\" style=\"aspect-ratio:0.7277498359938771;width:346px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2026\/07\/Screenshot-2026-07-08-at-4.36.03-PM.png 556w, https:\/\/wordpress.org\/documentation\/files\/2026\/07\/Screenshot-2026-07-08-at-4.36.03-PM-218x300.png 218w\" sizes=\"auto, (max-width: 556px) 100vw, 556px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The Image block settings panel is divided into two tabs \u2013&nbsp;<strong>Settings<\/strong>, and&nbsp;<strong>Styles<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Settings<\/h3>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"548\" height=\"386\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/block-settings-tab.png\" alt=\"Post Date Block Settings tab\" class=\"wp-image-16369333\" style=\"aspect-ratio:1.4197061085698093;width:329px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/block-settings-tab.png 548w, https:\/\/wordpress.org\/documentation\/files\/2022\/03\/block-settings-tab-300x211.png 300w\" sizes=\"auto, (max-width: 548px) 100vw, 548px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Default format<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">This option is toggled on when you first add a Date block. Your site&#8217;s Default format can be changed in the site settings area, see <a href=\"https:\/\/wordpress.org\/documentation\/article\/customize-date-and-time-format\/\">customize default date and time format<\/a> to learn how.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To change the Date block to use a different format from your site&#8217;s default format, toggle off the <strong>Default format<\/strong> settings.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can choose a format from a list of predefined selections under <strong>Choose a format<\/strong>. <\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"548\" height=\"818\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/Screenshot-2026-07-05-at-9.09.22-AM.png\" alt=\"Settings custom format dropdown options. \" class=\"wp-image-16369334\" style=\"aspect-ratio:0.6699203453611201;object-fit:cover;width:325px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/Screenshot-2026-07-05-at-9.09.22-AM.png 548w, https:\/\/wordpress.org\/documentation\/files\/2022\/03\/Screenshot-2026-07-05-at-9.09.22-AM-201x300.png 201w\" sizes=\"auto, (max-width: 548px) 100vw, 548px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Or you can choose <strong>Custom<\/strong> from the drop down and enter a new format string in the input box that appears. <\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"552\" height=\"568\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/Screenshot-2026-07-05-at-9.11.05-AM.png\" alt=\"Settings custom format dropdown options with Custom selected\" class=\"wp-image-16369335\" style=\"width:325px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/03\/Screenshot-2026-07-05-at-9.11.05-AM.png 552w, https:\/\/wordpress.org\/documentation\/files\/2022\/03\/Screenshot-2026-07-05-at-9.11.05-AM-292x300.png 292w\" sizes=\"auto, (max-width: 552px) 100vw, 552px\" \/><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Link to Post<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Toggle on the <strong>Link to post<\/strong> option to link the date to the URL of the post. In a Query Loop block, this enables the website visitor to go to the post by clicking on the Date.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Advanced<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The following Advanced settings options are available: HTML Anchor, Additional CSS Class(es), Additional CSS, and Styles.<\/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<h3 class=\"wp-block-heading\">Styles<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Color <\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The Date block provides Color settings options to change the text and background colors.<\/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\/\"><\/a><a href=\"https:\/\/wordpress.org\/documentation\/article\/more-options\/\"><\/a><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<h4 class=\"wp-block-heading\">Typography <\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The Date block provides typography settings to change the font family, size, appearance, line height, letter case, letter spacing, and decoration.<\/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\/\"><\/a><a href=\"https:\/\/wordpress.org\/documentation\/article\/typography-settings-overview\/\">Get more details about changing typography settings.<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Dimensions <\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The Date block block provides dimension settings options to change padding and margin 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\/dimension-controls-overview\/\">Learn more about dimension controls.<\/a><\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Border<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The Date block provides border settings options to add border color, width, and radius.<\/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\/border-settings-overview\/\">Learn more about border 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>Created 2026-07-08<\/li>\n<\/ul>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Go to the list of Blocks Use the Date block to display a custom date. Add a Date block To add the Date block, click the&nbsp;+ Block Inserter&nbsp;button in the top-left corner of the editor. Search for the Image block and click on the block to add it to the page. You can also quickly [&hellip;]<\/p>\n","protected":false},"author":20811757,"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-16369393","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\/16369393","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\/20811757"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16369393"}],"version-history":[{"count":10,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16369393\/revisions"}],"predecessor-version":[{"id":16369414,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16369393\/revisions\/16369414"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16369393"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16369393"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}