Skip to the documentation

Official documentation

WP Definitivo

An accessible block theme for modern sites and WooCommerce stores, built with native blocks, patterns and the Site Editor.

Documented version
1.0.0
WordPress
6.6 or later
PHP
7.4 or later
License
GPL v2 or later
Documentation contents
Introduction

Overview

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.

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.

Accessible by design

A skip link, labelled regions, a two-color focus indicator, controls at least 44 pixels tall and reduced motion support.

Optional store

With WooCommerce active, the theme presents the catalog, product, cart, checkout, order confirmation and My account pages with WooCommerce’s own blocks.

No tracking

No external requests, CDN, telemetry or fonts loaded from another server. Everything the theme uses ships in its own package.

Compatibility

System requirements

ComponentRequirementNotes
WordPress6.6 or laterTested up to 7.1.
PHP7.4 or laterUse a version your host still supports.
EditorSite EditorThe theme does not use the Customizer. Its appearance is managed in Appearance → Editor.
WooCommerceOptionalThe store templates are only used when the plugin is active.
Other pluginsNone requiredThe theme works on its own for pages, posts and a blog.
Getting started

Installation and updates

Install from the dashboard

  1. Go to Appearance → Themes → Add New Theme.
  2. Click Upload Theme and choose the WP Definitivo ZIP file.
  3. Click Install Now, then Activate.
  4. Open Appearance → Editor to review the templates, template parts and styles.

Update an existing installation

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.

Configuration

Recommended initial setup

  1. In Settings → General, set the site title and tagline. The header and the footer display both.
  2. To show a logo, edit the Header template part in the Site Editor and choose the image in the Site Logo block.
  3. Build the front page: under Pages → Add New, choose the Institutional front page pattern or, with WooCommerce active, Store front page. In the page settings, choose the Full-width page template and publish.
  4. In Settings → Reading, choose that page as the homepage and another page, such as Blog, as the posts page.
  5. Create the menus in Appearance → Editor → Navigation and choose each one in the Navigation block of the Header and Footer template parts. Until you choose a menu, the header and footer list the published pages.
  6. With WooCommerce active, check the shop, cart, checkout and My account pages in WooCommerce → Settings → Advanced. The theme applies the right templates to those pages.
Structure

Site Editor

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.

AreaWhat you adjust
NavigationThe header and footer menus.
StylesColors, typography, spacing and block styles, based on the theme presets.
PagesPage content, including the front page.
TemplatesThe structure of each kind of page, such as the blog, posts, archives, search, the 404 error and the store.
PatternsThe Header, Footer and Side cart template parts and the reusable patterns.
Design

Colors, typography and spacing

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.

SlugValueMain use
background#f6f8fcPage background
white#ffffffCards and surfaces
foreground#0f172aText and footer background
muted#475569Supporting text and metadata
accent#0f3d73Links and buttons
secondary#14599fButtons on hover
visited#5b2a86Visited links
soft#f0f3f9Blog and post content areas
content-border#0f305724Card borders
border#64748bField and control borders
border-subtle#d7dde5Dividers
success#146c43Success messages
error#a51d2dErrors and invalid fields
rating#a16207Rating stars

Default contrast ratios

CombinationContrast
Main text on the page background16.79:1
Secondary text on the page background7.13:1
Links on the page background10.21:1
White text on buttons10.85:1
White text on buttons, on hover7.10:1
Visited links on the page background9.32:1
Success text on the page background6.07:1
Error text on the page background7.02:1
Rating stars on white cards4.92:1
Control borders on white4.76:1

Typography

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.

SizeSlugValue
Smallsmall15 px
MediummediumFluid, from 16 to 18 px. This is the body text size.
LargelargeFluid, from 24 to 32 px
Extra largex-largeFluid, from 32 to 56 px
Hugexx-largeFluid, from 40 to 72 px

Widths and spacing

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.

Structure

Templates and template parts

TemplateWhen it is used
IndexFallback template for post lists without a template of their own.
Blog homeThe posts page: heading, a two-column post grid and a sidebar with search and recent posts.
Single postTitle, excerpt, categories, date, author, featured image, content, categories and tags, post navigation, comments and a sidebar.
Default pageA hero with the page title, the content inside a card and the comments, when they are enabled.
Full-width pageA hero with the page title, full width content and the comments, when they are enabled.
Page without titleFull width content without the page title, and the comments, when they are enabled. The content must start with the page’s main heading (H1).
ArchiveCategories, tags, authors and dates, with the term title and description.
Search resultsA results header and the list of posts.
Page not foundA 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.

Navigation

Header, menus and search

The header holds the logo, the site title and tagline, the primary menu and an expandable search. Submenus open on click or with the keyboard, not on pointer hover. On narrow screens the menu becomes a button that opens the navigation full screen.

The header search opens from the magnifying glass button, has a label for screen readers and a close button.

With WooCommerce active, it adds the account and cart buttons to the header. In the Customer account block, you choose to show the icon, the text or both, and whether the account opens a dropdown menu. The buttons grow with their content, never covering the search or the cart, and use the header’s text color.

The footer shows the site title and tagline, the footer menu, a copyright line with the year and your site name, and the WordPress and theme credits. All of it can be edited in the Footer template part.

Content

Patterns

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.

PatternCategoryUse
Front page heroDefinitivo – HighlightsFront page opening with the site title as a level 2 heading and a card of weekly highlights.
Accessible heroDefinitivo – HighlightsHigh contrast opening with a clear heading and short supporting text.
Two-column aboutDefinitivo – GeneralIntroduction to a company or project.
Community highlightsDefinitivo – GeneralTwo columns with projects and activities.
Contact detailsDefinitivo – GeneralContact details with clear labels, no form plugin needed.
TestimonialDefinitivo – GeneralA quote with a heading and a visible attribution.
Search sectionDefinitivo – SearchSearch field with a visible label and a text button.
Post gridDefinitivo – PostsThree recent posts with title, date and excerpt.
Three servicesDefinitivo – ServicesThree service cards in a logical reading order.
Service cardsDefinitivo – ServicesSix cards with a decorative icon and their own link, in a grid that adapts to the width.
Product gridDefinitivo – WooCommercePaginated product grid with the same card used in the store. Available only when WooCommerce is active.
Institutional front pageDefinitivo – GeneralA complete front page: opening, purpose, services, testimonial, latest news and contact details. Use it with the Full-width page template.
Store front pageDefinitivo – WooCommerceA 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.

Publishing

Blog, archives and posts

  • The posts page shows articles in a two-column grid, with a sidebar for search and recent posts.
  • Each post title links to the post. Excerpts do not use ambiguous links such as “Read more”.
  • Sticky posts get a border and elevation, not just a different color.
  • A single post opens with its title and excerpt, followed by categories, date, author, featured image, content, categories and tags, post navigation and comments.
  • Nested comments keep their structure on narrow screens, and comment pagination is the native WordPress one.
  • Posts split with the <!--nextpage--> marker get numbered page links.
  • A post without a title is shown as “Untitled post”, so the page never lacks a main heading.
E-commerce

WooCommerce store

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.

PageWhat the theme presents
Shop and categoriesBreadcrumbs, 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 cardImage, category, name linked to the product, price, sale badge and, in the shop and search results, a purchase button.
ProductBreadcrumbs, 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.
CartItems, 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.
CheckoutPurchase steps and WooCommerce’s native checkout.
Order confirmationSummary, downloads, addresses and next steps, for physical and digital products.
My accountA welcome banner, the native account navigation in a sidebar, dashboard shortcuts and the downloads table.
Side cartA 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.

Inclusion

Accessibility

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.

  • A “Skip to content” link, generated by WordPress from the main region of every template.
  • Labelled regions, with distinct names for the primary and footer navigation.
  • A single main heading (H1) per page and a consistent heading hierarchy.
  • A two-color focus indicator, visible on light and dark backgrounds.
  • Underlined links in content and a distinct color for visited links.
  • Buttons, fields and navigation controls at least 44 pixels tall.
  • Submenus that open on click and work with the keyboard. The Escape key closes the open submenu and returns focus to its button.
  • Reduced motion support and visible focus in forced colors mode.
  • Links with the same text and different destinations get names of their own, such as the latest comments, comment author names and categories that share a name with a tag.
  • In the store, the chosen price, stock and quantity are announced to screen readers, and the sorting list says that the product list updates when an option is chosen.
  • A screen-reader-text class for text meant only for screen readers.

Good practices for editors

  • Write alternative text for informative images, and leave it empty for decorative ones.
  • Use headings in order, without skipping levels.
  • Prefer link text that makes sense out of context.
  • Do not convey information through color alone.

To report an accessibility issue, email contato@wpdefinitivo.com with the affected page, the browser and, where applicable, the assistive technology you used.

Internationalization

Languages and translations

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.

Data

Privacy and external resources

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.

Loading

Performance

  • Global styles come from theme.json. Besides the main stylesheet, the product, checkout, order confirmation and My account stylesheets only load on the pages that use them.
  • The scripts are small, do not depend on jQuery and only load where they are needed.
  • The side cart stylesheet only loads when the mini cart is on the page.
  • Every file gets a version based on its modification date, so browsers fetch the new copy after an update.
Help

Troubleshooting

I updated the theme and the header did not change.

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.

The menu I created does not appear in the header.

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.

I cannot find the custom color option.

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.

The store pages do not use the theme layout.

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.

My changes do not show up on the site.

Clear the caching plugin, server and browser caches, then reload the page.

The theme appears in English.

Check the site language in Settings → General. The package includes Brazilian Portuguese. Other languages need a translation, as described in Languages and translations.

Scope

What the theme does not include

By design, WP Definitivo takes care of presentation. Features that change data or belong to plugins stay out of the theme:

  • a page builder or custom blocks;
  • custom post types, taxonomies and shortcodes;
  • contact forms;
  • SEO, analytics and tracking pixels;
  • a demo content importer;
  • auto-rotating sliders;
  • bundled or automatically installed plugins.

For those needs, choose plugins from the WordPress.org directory.

Project

Support, license and credits

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.