{"id":16075254,"date":"2022-11-02T07:22:09","date_gmt":"2022-11-02T07:22:09","guid":{"rendered":"https:\/\/wordpress.org\/support\/?post_type=helphub_article&#038;p=16075254"},"modified":"2026-05-23T14:34:25","modified_gmt":"2026-05-23T14:34:25","slug":"colors-settings-overview","status":"publish","type":"helphub_article","link":"https:\/\/wordpress.org\/documentation\/article\/colors-settings-overview\/","title":{"rendered":"Colors Settings overview"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">You can use the color settings in your <a href=\"https:\/\/wordpress.org\/documentation\/article\/blocks\/\" data-type=\"helphub_article\" data-id=\"11284652\">block<\/a> to set the text color, background color, link color, gradient options, and duotone filters for your content.&nbsp;They are designed to make it as simple as possible to update your block&#8217;s colors.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The color settings available will vary based on the theme and the block in use.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to access color settings <\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Colors can be set on a site basis or on a block basis. Setting color on a site basis will affect the color of the entire site.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to access color settings for your site<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>From your Administration Screens, Select Appearance &gt; Editor<\/li>\n\n\n\n<li>Select Styles<\/li>\n\n\n\n<li>Select Colors<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">How to access color settings for a single block<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Select the block you want to modify the color<\/li>\n\n\n\n<li>Open the Block Settings sidebar of a block by clicking the Settings icon that is to the right of the&nbsp;Publish&nbsp;or&nbsp;Save&nbsp;buttons.<\/li>\n\n\n\n<li>Find the Color section.<\/li>\n\n\n\n<li>or, In some blocks (e.g. Group block), the Color section is located in the Styles tab represented by a black and white circle.<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-1e63a3f2 wp-block-columns-is-layout-flex\" style=\"padding-right:var(--wp--preset--spacing--60);padding-left:var(--wp--preset--spacing--60)\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-full has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"566\" height=\"998\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-1-6.8.jpg\" alt=\"Color settings of Paragraph block\" class=\"wp-image-16365674\" style=\"border-width:1px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-1-6.8.jpg 566w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-1-6.8-170x300.jpg 170w\" sizes=\"auto, (max-width: 566px) 100vw, 566px\" \/><figcaption class=\"wp-element-caption\">Color settings of Paragraph block<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"538\" height=\"1024\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-2-6.8-538x1024.jpg\" alt=\"Color settings of Group block\" class=\"wp-image-16365675\" style=\"border-width:1px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-2-6.8-538x1024.jpg 538w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-2-6.8-158x300.jpg 158w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-2-6.8.jpg 562w\" sizes=\"auto, (max-width: 538px) 100vw, 538px\" \/><figcaption class=\"wp-element-caption\">Color settings of Group block<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\"><\/div>\n<\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Viewing all settings<\/h3>\n\n\n\n<figure class=\"wp-block-image alignright size-medium is-resized has-custom-border\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"151\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-all-settings-6.8-300x151.jpg\" alt=\"All color settings and Reset all\" class=\"wp-image-16365676\" style=\"border-width:1px;width:536px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-all-settings-6.8-300x151.jpg 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-all-settings-6.8-1024x517.jpg 1024w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-all-settings-6.8-768x388.jpg 768w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-all-settings-6.8.jpg 1090w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><figcaption class=\"wp-element-caption\">All color settings and Reset all<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">In the Color section, click on the three-dot menu (also known as an ellipsis) to explore all the color settings that are not visible by default. Note that not every block supports all the color settings.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Resetting all settings<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If you make customizations to these settings and want to revert back to the original settings quickly, you can do so by selecting the three-dot menu icon and clicking <strong>Reset all<\/strong>. This resets the settings and removes all of your changes.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Add a custom color<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">To add a custom color, click on the color box above the color palette options. It may read &#8220;no color selected&#8221; if your block is using the default color.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"691\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.29.30-AM-1024x691.png\" alt=\"Example of a custom color box with No color selected text\" class=\"wp-image-16368159\" style=\"width:468px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.29.30-AM-1024x691.png 1024w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.29.30-AM-300x202.png 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.29.30-AM-768x518.png 768w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.29.30-AM.png 1254w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Next, you can paste in a color HEX code or named color value such as black, darkblue, or deeppink.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"457\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.26.54-AM-1024x457.jpg\" alt=\"Editor showing result of pasting text deeppink when custom color picker is active\" class=\"wp-image-16368158\" style=\"aspect-ratio:2.240771667146559;width:675px;height:auto\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.26.54-AM-1024x457.jpg 1024w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.26.54-AM-300x134.jpg 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.26.54-AM-768x343.jpg 768w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.26.54-AM-1536x686.jpg 1536w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screenshot-2026-05-23-at-9.26.54-AM-2048x915.jpg 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Type of settings <\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Each supported block comes with different color settings.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Text and background colors<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This option allows you to change the color of the text, and background on the block you are working on. A combination of these color settings can be used to call attention to your most important content.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can pick a color from the color palette of your theme. You can also add a custom color from the color picker or enter the HEX, RGB, or HSL color values based on your brand. Click the two rectangle boxes next to the color slider to copy the HEX, RGB, or HSL color values. <\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1658\" style=\"aspect-ratio: 2390 \/ 1658;\" width=\"2390\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-text-and-background.mov\"><\/video><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Accessibility tests are built into the editor to warn you when the text may become hard to read against the background color choices as shown.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Link colors<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">On some blocks, you will find the option to change the link color. <\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1658\" style=\"aspect-ratio: 2390 \/ 1658;\" width=\"2390\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-link.mov\"><\/video><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Gradient background colors<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Some blocks such as the <a href=\"https:\/\/wordpress.org\/documentation\/article\/heading-block\/\" data-type=\"helphub_article\" data-id=\"11284925\">Heading block<\/a> allow you to set either a solid color or a gradient as the background. A gradient is a mix of two or more colors, displayed using a certain pattern (from lighter to darker, or one color blending into the other).<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1658\" style=\"aspect-ratio: 2390 \/ 1658;\" width=\"2390\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-background-gradient.mov\"><\/video><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">A slider will appear that shows the two color points that make up the gradient. <\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"592\" height=\"316\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/image-2.png\" alt=\"Color points in the gradient\" class=\"wp-image-16186847\" style=\"width:296px;height:158px\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/image-2.png 592w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/image-2-300x160.png 300w\" sizes=\"auto, (max-width: 592px) 100vw, 592px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">You can click on any of the two color points to display the color picker for changing the color value. You can either choose a color from the color picker or enter the HEX, RGB, or HSL color values.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can add additional color points if you like by clicking the&nbsp;<strong>+<\/strong>&nbsp;icon that appears when you hover over the gradient slider.<\/p>\n\n\n\n<div class=\"wp-block-columns is-layout-flex wp-container-core-columns-is-layout-0e47273b wp-block-columns-is-layout-flex\">\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"849\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-gradient-type-1024x849.jpg\" alt=\"Gradient type\" class=\"wp-image-16365679\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-gradient-type-1024x849.jpg 1024w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-gradient-type-300x249.jpg 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-gradient-type-768x637.jpg 768w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-settings-gradient-type.jpg 1148w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Screenshot<\/figcaption><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-layout-flow wp-block-column-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can choose between the <strong>Linear<\/strong> or <strong>Radial<\/strong> gradient type. The angle control shifts the position of the gradient.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The <strong>Linear<\/strong> type creates a gradient between the two colors along a straight line, whereas the <strong>Radial<\/strong> type starts from the center and moves to the borders.<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"558\" height=\"162\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/10\/gradient-example.png\" alt=\"Liner and Radial gradient options\" class=\"wp-image-16077634\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/10\/gradient-example.png 558w, https:\/\/wordpress.org\/documentation\/files\/2022\/10\/gradient-example-300x87.png 300w\" sizes=\"auto, (max-width: 558px) 100vw, 558px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Duotone filter<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You can create a two-tone color effect (called the duotone effect) on images without actually changing the original image<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The duotone filter option allows you to add this filter color to your block content from the block toolbar. The filter can be black, white, or&nbsp;<em>any<\/em>&nbsp;other color combination of your choosing. The duotone effect works best on high-contrast images.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To get started, select the Duotone filter icon in the block toolbar. You can pick the two colors for the effect from the list of duotone presets provided in the drop-down.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You can also pick your own colors for the shadows and highlights by clicking on the <strong>Shadows<\/strong> \/<strong>Highlights<\/strong> option which opens up the color picker and then selecting your custom color from the color palette.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you want to remove the duotone filter you can click the <strong>Clear<\/strong> button found at the bottom-right of the color palette.<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"1526\" style=\"aspect-ratio: 2240 \/ 1526;\" width=\"2240\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/Screen-Recording-2022-11-10-at-10.16.00-AM.mp4\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Reset settings<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When hovering over the Color option, if a color has been selected, a reset button (displayed as a dash icon) will appear. Clicking this button will remove the applied color and reset the field to its default state, indicating &#8220;No color selected.&#8221;<\/p>\n\n\n\n<figure class=\"wp-block-image aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"776\" height=\"418\" src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-reset.png\" alt=\"Reset color button\" class=\"wp-image-16365613\" srcset=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-reset.png 776w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-reset-300x162.png 300w, https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-reset-768x414.png 768w\" sizes=\"auto, (max-width: 776px) 100vw, 776px\" \/><figcaption class=\"wp-element-caption\">Reset color button<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<figure class=\"wp-block-video\"><video height=\"2194\" style=\"aspect-ratio: 3992 \/ 2194;\" width=\"3992\" controls src=\"https:\/\/wordpress.org\/documentation\/files\/2022\/11\/color-reset.mp4\"><\/video><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Demonstration<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">To illustrate the above settings, below is an example of how to add custom colors so that the social link icons will match the branding on your site:&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-video\"><video controls src=\"https:\/\/make.wordpress.org\/core\/files\/2022\/09\/social_icons.mp4\"><\/video><\/figure>\n\n\n\n<div class=\"wp-block-group changelog has-very-dark-gray-color has-very-light-gray-background-color has-text-color has-background is-layout-flow wp-block-group-is-layout-flow\">\n<h2 id=\"changelog\" class=\"wp-block-heading has-medium-font-size\">Changelog <\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Updated 2026-06-23\n<ul class=\"wp-block-list\">\n<li>Added custom color section<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Updated 2025-05-04\n<ul class=\"wp-block-list\">\n<li>Add site&#8217;s color settings.<\/li>\n\n\n\n<li>Update screenshots and videos. <\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Update 2025-04-22 (props to <a href=\"https:\/\/profiles.wordpress.org\/nikunj8866\/\">@nikunj8866<\/a>)\n<ul class=\"wp-block-list\">\n<li>Add color reset button.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Created 2022-11-01<\/li>\n<\/ul>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>You can use the color settings in your block to set the text color, background color, link color, gradient options, and duotone filters for your content.&nbsp;They are designed to make it as simple as possible to update your block&#8217;s colors. The color settings available will vary based on the theme and the block in use. [&hellip;]<\/p>\n","protected":false},"author":15769828,"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":[83,80],"class_list":["post-16075254","helphub_article","type-helphub_article","status-publish","hentry","category-block-editor","category-customization"],"revision_note":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16075254","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"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/comments?post=16075254"}],"version-history":[{"count":8,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16075254\/revisions"}],"predecessor-version":[{"id":16368161,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/articles\/16075254\/revisions\/16368161"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wporg\/v1\/users\/thelmachido"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/media?parent=16075254"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.org\/documentation\/wp-json\/wp\/v2\/category?post=16075254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}