Make it yours
A WPTom template has three layers you can change, from “no code at all” to “it’s your code now”. Most sites only ever need the first two. The examples on these pages use Handy; every template follows the same pattern, and where one differs, the page says so.
| What you want to change | Where | Code? |
|---|---|---|
| Texts, photos, prices, posts, services, the order of home page sections | The content editor (Keystatic, Sanity or EmDash) | No |
| Name, contact details, navigation, footer links, the picture for social previews | Site settings in the content editor | No |
| Button labels, form messages, emails, chat and 404 game texts | Interface texts in the content editor | No |
| Colors, fonts, corners | src/content/singletons/brand.json (Brand in Keystatic) |
No |
| Languages | src/i18n/locales.json plus the translated content |
No |
| The map of your area (templates with a map) | map.config.json, then npm run map -- fetch |
No |
| A new field, a new section type, a new page, the logo, the layout | src/ |
Yes |
Content: the CMS
Section titled “Content: the CMS”Every word on the site comes from the content, including button labels, error messages and
emails. Edit it in the content editor while npm run dev runs (/keystatic), or in the files
under src/content/ directly: they are the same thing. Start with
Your first site and Content and CMS.
The brand: brand.json
Section titled “The brand: brand.json”One small file holds your colors, fonts and corners. Every other color on the site (both themes, buttons, links, borders) is worked out from it and checked for contrast. Colors, fonts and logo.
The code
Section titled “The code”The templates are plain Astro projects: everything is in your folder and yours to change.
wptom update still brings in new template versions and keeps your edits.
- Home page sections: reorder, remove and duplicate sections, or add a new type.
- Add or remove a page: a page from content only, or a new route.
- Working in the code: where things are, the rules that keep the site fast and readable, updates and AI assistants.
- The content model: add a field to a page or a collection.
Before you launch
Section titled “Before you launch”Replace the demo business, its photos and its legal pages, set your site’s address, and check the build: Before you launch.