Native blocks
Templates, template parts and patterns you can edit in the Site Editor. What you build stays WordPress content, even if you switch themes one day.
Official documentation
An accessible block theme for modern sites and WooCommerce stores, built with native blocks, patterns and the Site Editor.
WP Definitivo is a block theme for modern sites and WooCommerce stores. The whole layout is built with native WordPress blocks, patterns and the Site Editor, with no page builder, no custom options panel and no code that ties your content to the theme.
Accessibility is part of the foundation. Semantic regions, visible focus, keyboard navigation, underlined links and colors with calculated contrast come ready, and the design choices in the editor are limited to tested combinations.
Templates, template parts and patterns you can edit in the Site Editor. What you build stays WordPress content, even if you switch themes one day.
A skip link, labelled regions, a two-color focus indicator, controls at least 44 pixels tall and reduced motion support.
With WooCommerce active, the theme presents the catalog, product, cart, checkout, order confirmation and My account pages with WooCommerce’s own blocks.
No external requests, CDN, telemetry or fonts loaded from another server. Everything the theme uses ships in its own package.
| Component | Requirement | Notes |
|---|---|---|
| WordPress | 6.6 or later | Tested up to 7.1. |
| PHP | 7.4 or later | Use a version your host still supports. |
| Editor | Site Editor | The theme does not use the Customizer. Its appearance is managed in Appearance → Editor. |
| WooCommerce | Optional | The store templates are only used when the plugin is active. |
| Other plugins | None required | The theme works on its own for pages, posts and a blog. |
Before updating, back up the database and the wp-content/themes/wp-definitivo folder. Upload the new version from the dashboard, then clear the WordPress, server and browser caches. Confirm the version in Appearance → Themes.
Everything about WP Definitivo’s appearance is edited in Appearance → Editor. There are no Customizer options and no custom panel: whatever the theme provides shows up in the editor as a template, template part, pattern or style.
| Area | What you adjust |
|---|---|
| Navigation | The header and footer menus. |
| Styles | Colors, typography, spacing and block styles, based on the theme presets. |
| Pages | Page content, including the front page. |
| Templates | The structure of each kind of page, such as the blog, posts, archives, search, the 404 error and the store. |
| Patterns | The Header, Footer and Side cart template parts and the reusable patterns. |
The theme defines a palette of 14 colors. Custom colors, gradients, duotone and the default WordPress palette are turned off on purpose, so every combination picked in the editor comes from pairs with verified contrast.
| Slug | Value | Main use |
|---|---|---|
background | #f6f8fc | Page background |
white | #ffffff | Cards and surfaces |
foreground | #0f172a | Text and footer background |
muted | #475569 | Supporting text and metadata |
accent | #0f3d73 | Links and buttons |
secondary | #14599f | Buttons on hover |
visited | #5b2a86 | Visited links |
soft | #f0f3f9 | Blog and post content areas |
content-border | #0f305724 | Card borders |
border | #64748b | Field and control borders |
border-subtle | #d7dde5 | Dividers |
success | #146c43 | Success messages |
error | #a51d2d | Errors and invalid fields |
rating | #a16207 | Rating stars |
| Combination | Contrast |
|---|---|
| Main text on the page background | 16.79:1 |
| Secondary text on the page background | 7.13:1 |
| Links on the page background | 10.21:1 |
| White text on buttons | 10.85:1 |
| White text on buttons, on hover | 7.10:1 |
| Visited links on the page background | 9.32:1 |
| Success text on the page background | 6.07:1 |
| Error text on the page background | 7.02:1 |
| Rating stars on white cards | 4.92:1 |
| Control borders on white | 4.76:1 |
Text uses the system sans-serif font stack with a 1.65 line height. The system serif and monospace stacks are also available. No font files are downloaded. Custom font sizes and drop caps are turned off.
| Size | Slug | Value |
|---|---|---|
| Small | small | 15 px |
| Medium | medium | Fluid, from 16 to 18 px. This is the body text size. |
| Large | large | Fluid, from 24 to 32 px |
| Extra large | x-large | Fluid, from 32 to 56 px |
| Huge | xx-large | Fluid, from 40 to 72 px |
Content is 720 px wide, and the wide width reaches 1280 px. The spacing scale has eight steps, from 8 px to a fluid value between 48 and 96 px.
| Template | When it is used |
|---|---|
| Index | Fallback template for post lists without a template of their own. |
| Blog home | The posts page: heading, a two-column post grid and a sidebar with search and recent posts. |
| Single post | Title, excerpt, categories, date, author, featured image, content, categories and tags, post navigation, comments and a sidebar. |
| Default page | A hero with the page title, the content inside a card and the comments, when they are enabled. |
| Full-width page | A hero with the page title, full width content and the comments, when they are enabled. |
| Page without title | Full width content without the page title, and the comments, when they are enabled. The content must start with the page’s main heading (H1). |
| Archive | Categories, tags, authors and dates, with the term title and description. |
| Search results | A results header and the list of posts. |
| Page not found | A 404 message, a search field and a link to the front page. |
| Store (WooCommerce) | Product Catalog; Products by Category, by Tag, by Attribute and by Brand; Product Search Results; Single Product; Cart; Checkout; Order Confirmation and My account. See WooCommerce store. |
The Header and Footer template parts appear in every template. The Side cart template part defines the content of the WooCommerce mini cart.
In the block inserter, the theme patterns are in the categories that start with Definitivo. They all use native blocks and start their headings at level 2, so they sit below the page title. After inserting one, replace the sample text with your own.
| Pattern | Category | Use |
|---|---|---|
| Front page hero | Definitivo – Highlights | Front page opening with the site title as a level 2 heading and a card of weekly highlights. |
| Accessible hero | Definitivo – Highlights | High contrast opening with a clear heading and short supporting text. |
| Two-column about | Definitivo – General | Introduction to a company or project. |
| Community highlights | Definitivo – General | Two columns with projects and activities. |
| Contact details | Definitivo – General | Contact details with clear labels, no form plugin needed. |
| Testimonial | Definitivo – General | A quote with a heading and a visible attribution. |
| Search section | Definitivo – Search | Search field with a visible label and a text button. |
| Post grid | Definitivo – Posts | Three recent posts with title, date and excerpt. |
| Three services | Definitivo – Services | Three service cards in a logical reading order. |
| Service cards | Definitivo – Services | Six cards with a decorative icon and their own link, in a grid that adapts to the width. |
| Product grid | Definitivo – WooCommerce | Paginated product grid with the same card used in the store. Available only when WooCommerce is active. |
| Institutional front page | Definitivo – General | A complete front page: opening, purpose, services, testimonial, latest news and contact details. Use it with the Full-width page template. |
| Store front page | Definitivo – WooCommerce | A complete store front page: opening, categories, featured products, offers and new arrivals. Use it with the Full-width page template. Available only with WooCommerce active and WordPress 6.7 or later. |
Both front pages also appear in the pattern window that opens when you create a new page. A product section with nothing to show, such as the offers when nothing is on sale, stays hidden on the site.
The WordPress core patterns are hidden, and the theme’s internal patterns, such as the header, the footer and the store content, do not appear in the inserter.
<!--nextpage--> marker get numbered page links.WooCommerce is optional. When it is active, the theme declares support for the plugin and presents the public store pages with WooCommerce’s native blocks. Prices, stock, shipping, taxes, payments and emails are still configured in WooCommerce itself.
| Page | What the theme presents |
|---|---|
| Shop and categories | Breadcrumbs, a banner with the title and description, category shortcuts with the current category marked, native price, category and brand filters, WooCommerce’s native sorting, result count and pagination. |
| Product card | Image, category, name linked to the product, price, sale badge and, in the shop and search results, a purchase button. |
| Product | Breadcrumbs, a square gallery with thumbnails, arrows and lightbox, details with category, brand, SKU and tags, rating, price, summary, purchase panels with the variations and the quantity with minus and plus buttons, description and reviews, and the You may also like (upsells) and Related products sections. |
| Cart | Items, native coupons, an order summary with subtotal, discounts and shipping, a Complete your order section with cross-sells and an empty state with a link back to the store. |
| Checkout | Purchase steps and WooCommerce’s native checkout. |
| Order confirmation | Summary, downloads, addresses and next steps, for physical and digital products. |
| My account | A welcome banner, the native account navigation in a sidebar, dashboard shortcuts and the downloads table. |
| Side cart | A mini cart with the items, a summary of the totals and the native purchase actions. |
To edit the store, open Appearance → Editor → Templates. The shop uses the Product Catalog template, and product categories, tags, attributes and brands each have their own. Texts and links can be changed and saved in the editor. To filter by an attribute, add the attribute filter to the filters block. To return to the theme’s version, use Reset in the template options.
Development follows the WordPress.org accessibility-ready guidelines. On October 15, 2026, the theme author completed an internal audit against WCAG 2.2 Level AA, with manual testing using the keyboard, zoom, text-only zoom, forced colors and the NVDA screen reader in Firefox and Chrome, including the store. It is not an independent audit, and the accessibility-ready tag only applies after the WordPress.org review. The accessibility.txt file in the theme folder holds the accessibility statement, the testing methodology and the features.
screen-reader-text class for text meant only for screen readers.To report an accessibility issue, email contato@wpdefinitivo.com with the affected page, the browser and, where applicable, the assistive technology you used.
The theme’s source language is English. A Brazilian Portuguese translation ships with the package, so a site set to Português do Brasil shows the theme in Portuguese with no extra download.
For another language, use languages/wp-definitivo.pot as the base and save the translations as languages/LOCALE.po and languages/LOCALE.mo, replacing LOCALE with the language code. JavaScript messages also need the JSON files for the wp-definitivo domain. The instructions are in languages/README.md.
Text saved in the database, such as pages, products, menus and patterns you already inserted, does not change when the theme language changes.
WP Definitivo does not track visitors or administrators, sets no cookies of its own and makes no requests to external services. There is no telemetry, CDN, remote font, demo importer or custom update system.
Plugins such as WooCommerce have their own data practices, like the cart session cookies. Check each plugin’s documentation and keep your site’s privacy policy up to date.
theme.json. Besides the main stylesheet, the product, checkout, order confirmation and My account stylesheets only load on the pages that use them.The Header template part was customized in the Site Editor, and the version saved in the database takes precedence over the theme file. Use Reset on that template part to return to the theme version. Your changes to it will be discarded.
Creating a menu does not add it to the header. Select the Navigation block in the Header template part, choose the menu you want and save. Until you do, the header lists the published pages.
It is a theme decision: the editor only offers the palette with verified contrast. If you need other colors, create a child theme and check the contrast of every combination.
Make sure WooCommerce is active and the pages are set in WooCommerce → Settings → Advanced. If a page has another template selected in its own settings, that template takes precedence.
Clear the caching plugin, server and browser caches, then reload the page.
Check the site language in Settings → General. The package includes Brazilian Portuguese. Other languages need a translation, as described in Languages and translations.
By design, WP Definitivo takes care of presentation. Features that change data or belong to plugins stay out of the theme:
For those needs, choose plugins from the WordPress.org directory.
For questions, accessibility issues or bug reports, use the contact page or email contato@wpdefinitivo.com.
WP Definitivo is distributed under the GNU General Public License v2 or later. The icons and the screenshot were created for the theme and use the same license. The theme uses system fonts and bundles no third-party fonts or images.
The version history is in the theme’s readme.txt file.
WP Definitivo is an independent project and is not affiliated with the WordPress Foundation, Automattic or WooCommerce.