CMS Site Page Update Guide

This guide maps each website page to its exact CMS editing location, with annotated Keystatic-to-site workflows for fast, confident updates.

How To Use This Guide

Find the page URL you want to update.
Open the matching section below.
Go to the exact CMS sidebar path and edit the listed field groups.
Save, then verify the page(s) listed in that section.

Annotated Workflow Diagrams (Real UI Screenshots)

These workflows are built from actual Keystatic and site screenshots (not mockups), with annotations that highlight:

where to edit in CMS
what each field block controls on the website
what to verify before publishing

1) Homepage Hero Update

Homepage hero annotated workflow

2) Events List Update

Events list annotated workflow

3) Event Detail Update

Event detail annotated workflow

4) Tracks Overview Update

Tracks overview annotated workflow

5) FAQ Update

FAQ annotated workflow

6) Partners Update

Partners annotated workflow

7) Run Groups Update

Run groups annotated workflow

8) Track Pass Update

Track pass annotated workflow

9) About Page Update

About page annotated workflow

10) Contact Page Update

Contact page annotated workflow

11) Getting Started Page Update

Getting started page annotated workflow

12) Ladies Intro Page Update

Ladies intro page annotated workflow

13) Instructors Page Update

Instructors page annotated workflow

14) Media Page Update

Media page annotated workflow

15) Referral Program Page Update

Referral program page annotated workflow

16) Gift Cards Page Update

Gift cards page annotated workflow

17) Requirements Page Update

Requirements page annotated workflow

18) Privacy Policy Page Update

19) Terms Of Service Page Update

20) 404 Page Update

404 page annotated workflow

21) Track Guide Detail Update

Track guide page annotated workflow

22) Events Archive Update

Events archive annotated workflow

Regenerate Or Expand Workflow Diagrams

Update source screenshots:
- CMS screenshots: docs/assets/content-update-guide/source-cms/
- Site screenshots: docs/assets/content-update-guide/source-site/
Edit workflow definitions in scripts/generate-content-update-workflow-diagrams.mjs (titles, callout boxes, annotation text).
Regenerate diagrams:
- npm run docs:generate-content-workflows
Commit:
- public/assets/content-update-guide/*.svg
- docs/assets/content-update-guide/*.svg
- src/guides/cms-site-page-update-guide.md (if embed list or live-guide copy changes)
- docs/CMS_SITE_PAGE_UPDATE_GUIDE.md (if standalone docs copy should stay in sync)

Events, Run Groups & Tracks
- Events
- Run Groups
- Tracks
- Track Guides
Pages
- Home Page
- Events Page
- Tracks Page
- Instructor Requirements
Getting Started
- Getting Started Page
- Run Groups Page
- Requirements
- FAQ
Programs
- Track Pass
- Referral Program
- Gift Cards
- Parade Laps
- Ladies Intro Page
About
- About Page
- Media
- Partners
- Contact Page
Site Settings
- Event Detail Defaults
- Company Info
- Navigation
- Cancellation Policy
Legal & System
- Privacy Policy Page
- Terms of Service Page
- 404 Page

Shared Content That Affects Many Pages

Site Settings > Navigation
- Controls header/footer/mobile navigation across the site.
Site Settings > Company Info
- Drives shared values like email, formspreeEndpoint, and tokenized values used in multiple pages.
Events, Run Groups & Tracks > Events, Tracks, and Run Groups
- Feed multiple routes (/, /events.html, /events/[slug].html, /tracks.html, calendar feeds).
Programs > Ladies Intro Page
- Its price is used by tokenized content in other places.
Getting Started > Requirements
- Provides the shared tech form URL fallback used on /events/[slug].html.

Icon Picker Notes

Fields labeled Icon or Lucide Icon Name now use a categorized icon picker in Keystatic.
You can search by icon name and pick directly from the modal; no manual slug memorization needed.
Icon-heavy areas include Run Groups > details[], Requirements > driver.cards[], and Programs > Parade Laps > features[].

Route Coverage Quick Map

Route	Primary CMS Source(s)
`/`	`Home Page`, `Events`, `Tracks`, `Run Groups`, `Partners`, `Ladies Intro Page`, `Company Info`
`/about.html`	`About Page`, `Tracks`, `Company Info`, `Events`, `Ladies Intro Page`
`/contact.html`	`Contact Page`, `Company Info`, `Events`, `Tracks`, `Ladies Intro Page`
`/events.html`	`Events Page`, `Events`, `Tracks`, `Run Groups`
`/events/[slug].html`	`Events`, `Tracks`, `Run Groups`, `Cancellation Policy`, `Event Detail Defaults`, `Requirements`, `Company Info`
`/events/archive.html`	`Events`, `Tracks`
`/tracks.html`	`Tracks Page`, `Tracks`
`/tracks/[trackId]/guide.html`	`Track Guides`, `Tracks`
`/run-groups.html`	`Run Groups Page`, `Run Groups`
`/faq.html`	`FAQ`, `Company Info`, `Events`, `Tracks`, `Ladies Intro Page`
`/getting-started.html`	`Getting Started Page`
`/ladies-intro.html`	`Ladies Intro Page`, `Company Info`, `Events`, `Tracks`
`/instructors.html`	`Instructor Requirements`, `Company Info`
`/partners.html`	`Partners`
`/media.html`	`Media`
`/track-pass.html`	`Track Pass`
`/referral-program.html`	`Referral Program`
`/gift-cards.html`	`Gift Cards`, `Company Info`
`/parade-laps.html`	`Parade Laps`
`/requirements.html`	`Requirements`
`/privacy.html`	`Privacy Policy Page`
`/terms.html`	`Terms of Service Page`
`404`	`404 Page`

Page-By-Page Update Instructions

Home Page (`/`)

CMS path:
- Pages > Home Page
- Events, Run Groups & Tracks > Events
- Events, Run Groups & Tracks > Tracks
- Events, Run Groups & Tracks > Run Groups
- About > Partners
- Programs > Ladies Intro Page
- Site Settings > Company Info
Main Home Page field groups:
- hero
- upcomingEvents
- whySection
- gettingStartedCta
- runGroupsSection
- testimonialsSection
- ladiesSection
- communitySection
- statsSection
- partnersSection
Verify:
- /
- /events.html (if event cards/pricing changed)
- /partners.html (if partner cards changed)

About (`/about.html`)

CMS path:
- About > About Page (primary content)
- Events, Run Groups & Tracks > Tracks (linked track cards/content)
- Site Settings > Company Info, Events, Run Groups & Tracks > Events, Programs > Ladies Intro Page (tokenized values in copy)
Main field groups:
- hero
- story
- stats
- values
- tracks
- cta
Verify:
- /about.html
- /tracks.html (if track data changed)

Contact (`/contact.html`)

CMS path:
- About > Contact Page
- Site Settings > Company Info (for email and Formspree endpoint)
- Events, Run Groups & Tracks > Events, Tracks, Programs > Ladies Intro Page (tokenized values)
Main field groups:
- hero
- formSection
- formFields
- infoCards
- social
- validationMessages
Shared values:
- Company Info > email
- Company Info > formspreeEndpoint
Verify:
- /contact.html
- Submit test form in preview

Events List (`/events.html`)

CMS path:
- Pages > Events Page (hero and link labels)
- Events, Run Groups & Tracks > Events
- Events, Run Groups & Tracks > Tracks
- Events, Run Groups & Tracks > Run Groups
Events Page fields:
- hero.title
- hero.subtitle
- hero.calendarLinkText
- hero.archiveLinkText
Events entry fields used heavily here:
- title
- trackId
- location
- dates.start, dates.end (display labels and duration are derived automatically)
- eventProfile.pricing.*
- eventProfile.runGroupsAvailable
- eventProfile.runGroupsSoldOut
- status
- sellingFast
- featured
- featuredText
- registrationUrl
Run-group rule:
- eventProfile.runGroupsAvailable and runGroupsSoldOut must use IDs that exist in the Run Groups collection. The event editor options are sourced from that collection.
Verify:
- /events.html
- /events/[slug].html for edited event(s)
- /events/archive.html if moving status/date boundaries

Event Detail (`/events/[slug].html`)

CMS path:
- Events, Run Groups & Tracks > Events (primary)
- Events, Run Groups & Tracks > Tracks (fallback location/media/map)
- Events, Run Groups & Tracks > Run Groups (labels/colors/rules)
- Site Settings > Cancellation Policy
- Site Settings > Event Detail Defaults
- Getting Started > Requirements (shared tech form fallback URL)
- Site Settings > Company Info (contact email fallback)
Events fields commonly edited:
- title, trackId, location
- dates (display labels and duration are derived automatically)
- eventProfile.pricing.*
- eventProfile.eventOptions[]
- eventProfile.runGroupsAvailable, eventProfile.runGroupsSoldOut
- specialPrograms[]
- specialEventDetails
- eventDetailImages[]
- hotel
- camping
- soundLimit
- requirementsSectionTitle
- requirements[], requirementsLinkText, requirementsLinkHref
- scheduleDownloadUrl, scheduleCardTitle, scheduleCardText, scheduleCardButtonText
- techFormUrl, techFormCardTitle, techFormCardText, techFormCardButtonText
- image (overrides the default track/event hero image)
- eventDetailImages[] (additional ordered event photos shown below the download cards)
- status
- sellingFast
- featured, featuredText
- registrationUrl
Event Detail Defaults fields:
- requirements, requirementsLinkText, requirementsLinkHref
- insurance
- pastEventMessage, pastEventCtaText
- questionsTitle, questionsText
Fallback behavior:
- New event records prefill requirementsLinkHref and techFormUrl with the standard Just Track It URLs.
- Leave scheduleDownloadUrl blank to use the linked track’s fallbackScheduleDownloadUrl.
- Leave optional schedule/tech card override text blank to use built-in defaults.
- Leave event-level requirements[] empty to use Site Settings > Event Detail Defaults > requirements.
- Leave requirementsLinkHref blank on an event to use Site Settings > Event Detail Defaults > requirementsLinkHref, then /requirements.html.
Verify:
- Edited event detail page
- /events.html
- /requirements.html (if tech form/requirements links changed)
- /terms.html (if policy wording changed)

Events Archive (`/events/archive.html`)

CMS path:
- Events, Run Groups & Tracks > Events
- Events, Run Groups & Tracks > Tracks
Behavior:
- Archive is date/status driven from event content.
Verify:
- /events/archive.html
- /events.html

Tracks Overview (`/tracks.html`)

CMS path:
- Pages > Tracks Page (hero/intro/CTA copy)
- Events, Run Groups & Tracks > Tracks
Tracks Page fields:
- hero.title, hero.subtitle
- introText
- cta.title, cta.text, cta.buttonText, cta.buttonHref
Main fields:
- id, name, displayName, location
- archived (hide from public track listings without breaking past event references)
- description, overview
- length, turns, stats
- features
- website, directions, map
- accommodations
Workflow note:
- If a track is still referenced by any event, archive it instead of deleting it. Archived tracks stay valid for historical event pages but are hidden from /tracks.html and excluded from {{trackCount}}.
Verify:
- /tracks.html
- /tracks/[trackId]/guide.html
- /events/[slug].html for events using that track

Track Guide Detail (`/tracks/[trackId]/guide.html`)

CMS path:
- Events, Run Groups & Tracks > Track Guides
- Events, Run Groups & Tracks > Tracks (fallback hero/map/location data)
Main Track Guides fields:
- slug (must match track id)
- subtitle
- metaDescription
- heroImage
- content (Markdoc)
Verify:
- /tracks/[trackId]/guide.html
- /tracks.html

Run Groups (`/run-groups.html`)

CMS path:
- Getting Started > Run Groups Page (page hero/sections/CTA)
- Events, Run Groups & Tracks > Run Groups (group definitions used site-wide)
Run Groups Page field groups:
- hero
- importantNote
- progressionSectionTitle
- comparisonSection
- cta
Main fields:
- id, name, shortName, color, displayOrder
- experienceRequired, description, classificationNote, passingRules
- features[]
- additionalFee
- details[] (label, value, icon)
- comparison
Verify:
- /run-groups.html
- /events.html
- /events/[slug].html

FAQ (`/faq.html`)

CMS path:
- Getting Started > FAQ
- Site Settings > Company Info, Events, Run Groups & Tracks > Events, Tracks, Programs > Ladies Intro Page (tokenized values)
Main fields:
- slug
- category
- questions[] (question, answer)
Verify:
- /faq.html

Getting Started (`/getting-started.html`)

CMS path:
- Getting Started > Getting Started Page
Main field groups:
- hero
- whatYouNeed
- beforeEvent
- eventDay
- register
- cta
Verify:
- /getting-started.html

Ladies Intro (`/ladies-intro.html`)

CMS path:
- Programs > Ladies Intro Page
- Site Settings > Company Info, Events, Run Groups & Tracks > Events, Tracks (tokenized/derived values)
Main field groups:
- hero
- featureImage, featureImageAlt
- pricing
- perfectFor
- schedule
- requirements
- bonus
- cta
Verify:
- /ladies-intro.html
- / (if tokenized ladies price text is used)

Instructors (`/instructors.html`)

CMS path:
- Pages > Instructor Requirements
Main field groups:
- hero
- benefitCards
- trainingBadgeImage, trainingBadgeAlt
- trainingDescription, trainingFeatures
- certifications
- experience
- expectations
- contactEmail
- cta
Verify:
- /instructors.html

Partners (`/partners.html`)

CMS path:
- About > Partners
Main fields:
- id, name, category
- description, offer, url
- logo
- displayOrder
- showOnHomepage
Verify:
- /partners.html
- / (homepage partner strip)

Media (`/media.html`)

CMS path:
- About > Media
Main field groups:
- title, description, heroSubtitle
- featured[]
- featuredSectionTitle, featuredSectionSubtitle
- socialSectionTitle, socialSectionText
- socialMedia
- photographyPartner
- pressSectionTitle, pressSectionText, pressContact
Verify:
- /media.html

Track Pass (`/track-pass.html`)

CMS path:
- Programs > Track Pass
Main field groups:
- name, heroSubtitle
- price, period
- description
- benefits
- valueCards
- savingsExamples
- savingsNote, noMembershipNote
- partnerDiscounts
- registrationUrl
Verify:
- /track-pass.html

Referral Program (`/referral-program.html`)

CMS path:
- Programs > Referral Program
Main field groups:
- name, tagline, description
- howItWorks[] (step, title, description, optional buttonText, optional buttonUrl)
- benefits
- terms[]
Verify:
- /referral-program.html

Gift Cards (`/gift-cards.html`)

CMS path:
- Programs > Gift Cards
- Site Settings > Company Info (contact email)
Main field groups:
- name, tagline, description
- howToPurchase
- options[]
- terms[]
Verify:
- /gift-cards.html

Parade Laps (`/parade-laps.html`)

CMS path:
- Programs > Parade Laps
Main field groups:
- hero
- description
- price
- features[]
- howItWorks[]
- cta
Verify:
- /parade-laps.html

Requirements (`/requirements.html`)

CMS path:
- Getting Started > Requirements
Main field groups:
- hero
- sidebar
- driver
- helmet
- vehicle
- techInspection
- convertibles
- cta
- techFormUrl
Verify:
- /requirements.html
- /events/[slug].html (if shared tech form URL changed)

Privacy Policy (`/privacy.html`)

CMS path:
- Legal & System > Privacy Policy Page
Main field groups:
- hero
- introParagraphs[]
- sections[]
Verify:
- /privacy.html

Terms (`/terms.html`)

CMS path:
- Legal & System > Terms of Service Page
Main field groups:
- hero
- introParagraphs[]
- sections[]
Verify:
- /terms.html

404 Page

CMS path:
- Legal & System > 404 Page
Main field groups:
- errorCode
- title
- message
- primaryButton
- secondaryButton
- quickLinksTitle
- quickLinks[]
Verify:
- Non-existent URL in preview (for example /this-page-does-not-exist)

Feeds (Not Pages, But CMS-Driven)

/calendar.ics
- Uses Events + Tracks
/events/[slug].ics
- Uses Events + Tracks

Important Limits (Developer Update Required)

Some content is still hardcoded in templates and not currently editable from CMS:

Many route-level SEO meta title/description values.
Some hero/section framing copy on selected pages.
Some fallback text in templates when CMS fields are empty.

If you cannot find a field in the CMS for visible page text, flag it as a developer task.

Page Publishing Checklist

Edit the target CMS entry and save.
Open preview and verify the exact route.
Verify any linked/affected routes listed above.
Check desktop and mobile.
Confirm links, emails, and registration URLs.
Merge only after preview matches intent.