Appearance
Editing content
How to update copy on the site's static pages, blog posts, and product data.
Where each thing lives
| Content | Where |
|---|---|
| Home hero copy + CTA | Customize → Homepage hero |
| Category tiles on home | Customize → Shop by category |
| Editorial band | Customize → Editorial band |
| Newsletter band | Customize → Newsletter band |
| Footer copyright | Customize → Footer |
| Social links | Customize → Social links |
| About us page | Pages → About us → uses block patterns |
| Contact us page | Pages → Contact us → uses block patterns |
| Shipping / Returns / Privacy / Terms | Pages → matching page → uses block patterns |
| Blog posts | Posts → All Posts |
| Products | Products → All Products |
| Category descriptions | Products → Categories → click into a category |
About / Contact / legal pages
Each of these uses a block pattern reference — one line of code that inflates into a full section at render time.
Option 1 — swap or add patterns (structural changes):
- Pages → edit the page
- Top-right
⋮menu → Code editor - You'll see lines like
<!-- wp:pattern {"slug":"dankcave/about-hero"} /-->— delete or add - Switch to Visual editor to preview → Update
See the pattern catalog for available slugs.
Option 2 — edit the pattern content (copy changes):
Pattern content lives in theme/patterns/{slug}.php. Edit that file, ship a new theme version. See Go live for the deploy path.
Content model note: don't type over the pattern block in the visual editor — Gutenberg will detach it and you lose the ability to update via theme upgrades.
Publishing a blog post
Blog posts are stock WP Posts. Theme picks up title, excerpt, featured image, category, content automatically.
- Posts → Add New
- Enter title
- Write body in the editor
- Set Excerpt (Document sidebar) — becomes summary on cards + lede on post
- Assign one Category (Document sidebar)
- Set a Featured Image — set alt text before publishing
- Publish
Gotcha: if pasting from Google Docs or Notion, use ⌘⇧V (paste as plain text).
Uploading product images
- Square (1:1)
- ≥ 800×800 (larger is better — PDP zoom uses the original size)
- White or transparent background
- Under 300 KB per image (compress via Squoosh or WP Smush)
- Set alt text on every image in Media Library
Product categories
Assign every product to at least one category. Categories drive:
- Shop-archive sidebar filter
- Home category-showcase tile grid (Customize → Shop by category)
- About page category-showcase pattern
- Product schema on PDPs (JSON-LD)
Recommended structure: 5-6 top-level categories, minimal nesting.
Gotcha: the category-showcase pattern hardcodes 5 category slugs. Renaming a category (which changes the slug) breaks it. Keep slugs stable or update patterns/category-showcase.php.
Search behavior
Search queries product title, short description, and tags. To make a product findable by an alternate name (brand nickname), add it to Tags or short description.
Site-wide search runs at /?s={query}. Header search modal autocompletes as you type (min 2 chars, 220 ms debounce).