How to make WordPress directory patterns match your theme Canonical: https://patternpaste.com/blog/wordpress-pattern-directory-colour-count/ Patterns (https://patternpaste.com/blog/tag/patterns/)Block themes (https://patternpaste.com/blog/tag/block-themes/)WordPress (https://patternpaste.com/blog/tag/wordpress/) Tutorial # How to make WordPress directory patterns match your theme Replace custom colours with your theme's palette, check preset names and test a style variation before reusing a WordPress directory pattern. Jake 1 November 2026 5 min read You paste a pattern into a page. The layout works, but the background is still cream and the button is still blue. Neither colour appears anywhere else on your site. The usual fix is to select those blocks and choose colours from your theme's palette. Of the 2,387 English patterns in the WordPress Pattern Directory (https://wordpress.org/patterns/) on 1 November 2026, 1,568 had a colour value saved directly into their text, backgrounds, borders or gradients. Those values don't change when you change the theme's palette. That doesn't make them bad patterns. Someone chose those colours to make the design work, and you might like the result exactly as it is. But if you're choosing a layout for a client's site, it helps to know which parts will follow the theme and which you'll be maintaining separately. ## What the directory count tells us# The count covered every English pattern available through the directory's public API (https://api.wordpress.org/patterns/1.0/?per_page=100&locale=en_US) on that date. We searched the markup for colour values and preset names, then compared the names with WordPress's core colours and the palettes in Twenty Twenty-Four and Twenty Twenty-Five. How colour is set | Patterns | Share | No colour set, or only names recognised by either default theme; also allows colours on cover overlays and social icons | 263 | 11.0% | Only fixed core colours, such as white and black | 417 | 17.5% | A colour name neither default theme defines, such as charcoal-0 | 139 | 5.8% | A colour value written into text, a background, a border or a gradient | 1,568 | 65.7% | Each pattern appears once. A pattern with a custom background goes in the last row even if everything else uses the theme's palette. Colours on social icons, cover overlays, shadows and duotone were set aside rather than counted as fixed text or surface colours. Only 263 met those criteria for following the theme. That's a narrower claim than saying they work on every site: this was a markup count, and a colour name recognised by a default theme may mean something different in yours. We didn't render every pattern or test its contrast. The patterns WordPress loads into the editor also differ from the directory as a whole. WordPress requests keyword 11 (https://github.com/WordPress/wordpress-develop/blob/trunk/src/wp-includes/block-patterns.php); of those 44 patterns (https://api.wordpress.org/patterns/1.0/?per_page=100&locale=en_US&pattern-keywords=11), 15 had colour values saved directly into text or surfaces. ## 1. Replace custom colours with palette colours# Start with the outer group, then check nested groups, headings and buttons. In the colour settings, replace any custom colour you want the theme to control with a swatch from the theme's palette. If the block should use the surrounding section's colour, try clearing its colour setting instead. Here's what a custom background looks like in the Code editor: The block is asking for #f2f0e9. It isn't asking for your theme's background colour, even if they happen to look the same today. Choosing a palette swatch gives WordPress a named colour to use instead. It's easy to see how these values end up in directory patterns. The submission rules (https://wordpress.org/documentation/article/submit-your-block-pattern-to-the-directory/#restrictions) limit the creator to core colours and duotone presets. An author who wants a particular cream has to choose a custom colour, without knowing anything about the site where you'll use it. You don't need to remove every custom colour on principle. Keep one if it's part of the design you want. The trade-off is that you'll have to edit that block separately if the site's colours change later. ## 2. Check that named colours belong to your theme# A preset name is useful only if your theme knows what it means. This block, for example, asks for a colour called charcoal-0: If your theme doesn't define that name, the intended background won't be applied through that preset. WordPress doesn't put a warning beside the block to explain why. Select it and choose a colour your theme does provide. Core names need a little thought too. A pattern using white and black may look good across several themes, but those colours generally stay white and black when you switch palettes. Keep them when that fixed contrast is deliberate; replace them when the section should use your theme's foreground and background colours. ## 3. Change the style variation before copying the section# Once you've adjusted the colours, switch to another style variation in the Site Editor and look at the page. A noticeably different palette makes it easier to spot a button or nested group you missed. Then switch back. Check text and backgrounds together. If a dark background changes to a light one while the heading stays white, the section can become unreadable even though each individual colour setting looked reasonable. The same goes for button labels and links. Do this before you repeat the section across the site. Fixing the original won't update copies you've already pasted elsewhere. That's where a small colour choice becomes an irritating job during a rebrand. ## Try the same Cover pattern in different themes# This is our Hero cover bookmark (https://patternpaste.com/pattern/hero-cover-bookmark.html) Core Pattern. A Cover block holds the café photograph, with the words on an inset panel. Choose another theme in the preview to change the panel's colours, type and button while keeping the same layout and photograph. Live Core Pattern Hero cover bookmark View pattern (https://patternpaste.com/pattern/hero-cover-bookmark.html) Choose a theme to see the same Core Pattern use its colours and typography. The photograph and layout stay the same. The inherited version shown here uses theme presets, with fallback colour references for themes that don't define every name. It has no fixed palette or font family of its own. Our Styled looks are a separate choice for when you want a particular palette and type treatment. We also render our patterns in WordPress and check block validity, theme inheritance, contrast and responsive layout, then review the screenshots. That catches problems a markup count like this one can't show. How we test (https://patternpaste.com/how-we-test/) explains the checks and their limits; you should still check the result with your own theme and content. ## The directory is still worth using# All 2,387 patterns in the count use core blocks, as the submission rules require. Only 7 state a font family, and only 30 include a raw HTML block. You can get a useful layout without installing another block plugin to keep it working. It's also free and moderated by volunteers (https://wordpress.org/patterns/about/). The guidelines ask for patterns that work across themes, but that doesn't mean every submission will arrive wearing your site's colours. Allow for some editing when you choose one. For your next pattern, make those edits in a draft first: choose the palette colours, check any unfamiliar preset names, and try another style variation. Once it behaves the way you want, copy it to the pages where you need it. Pattern Paste is a library of 542 WordPress block patterns, with 64 free to copy (https://patternpaste.com/patterns/free/). How we test (https://patternpaste.com/how-we-test/) explains the checks we run across Twenty Twenty-Five and Twenty Twenty-Four. Written by Jake 1 November 2026 ## Keep reading. All 16 articles (https://patternpaste.com/blog/) 27 October 2026 4 min read Patterns ### Free WordPress block patterns: where to find good ones, and how to tell (https://patternpaste.com/blog/free-wordpress-block-patterns/) 31 August 2026 4 min read Patterns ### Where block patterns come from, and what each source leaves in your page (https://patternpaste.com/blog/where-block-patterns-come-from/) 27 October 2026 6 min read Block themes ### How to build a landing page in WordPress without a page builder (https://patternpaste.com/blog/wordpress-landing-page-without-a-page-builder/) 8 Themes · 542 patterns · 58 interactive ## Your next site, finished sooner. Start a whole site from a theme, or add one section to the site you have. Browse themes (https://patternpaste.com/themes/)Subscribe (https://patternpaste.com/account/)