Skip to content

Editing content

How to update copy on the site's static pages, blog posts, and product data.

Where each thing lives

ContentWhere
Home hero copy + CTACustomize → Homepage hero
Category tiles on homeCustomize → Shop by category
Editorial bandCustomize → Editorial band
Newsletter bandCustomize → Newsletter band
Footer copyrightCustomize → Footer
Social linksCustomize → Social links
About us pagePages → About us → uses block patterns
Contact us pagePages → Contact us → uses block patterns
Shipping / Returns / Privacy / TermsPages → matching page → uses block patterns
Blog postsPosts → All Posts
ProductsProducts → All Products
Category descriptionsProducts → Categories → click into a category

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):

  1. Pages → edit the page
  2. Top-right menu → Code editor
  3. You'll see lines like <!-- wp:pattern {"slug":"dankcave/about-hero"} /--> — delete or add
  4. 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.

  1. Posts → Add New
  2. Enter title
  3. Write body in the editor
  4. Set Excerpt (Document sidebar) — becomes summary on cards + lede on post
  5. Assign one Category (Document sidebar)
  6. Set a Featured Imageset alt text before publishing
  7. 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).

Dankcave theme v0.2.2