CMS Content (Payload)
Payload collections (Mongo). All text/media fields are localized (Payload localization) per i18n.
Collections
post (blog)
post {
id: string
slug: string // unique per locale
title: localized<string>
excerpt: localized<string>
body: localized<richText/blocks> // DIY WYSIWYG block editor
coverImage: mediaRef
author: relation<user>
categories: relation<category>[]
tags: string[]
status: 'draft'|'published'|'scheduled'
publishedAt?: Date
seo: { metaTitle: localized<string>; metaDescription: localized<string>; ogImage?: mediaRef }
}
page (landing/static)
page {
id; slug; title: localized; blocks: localized<blocks[]>; // hero, features, FAQ, CTA, calculator-embed
status; seo
}
testimonial
testimonial {
id
customer: { name: string; city?: string; medusaCustomerId?: string }
assetRef?: string // verified-purchase link
rating: number // 1..5
quote: localized<string>
media?: mediaRef[] // install photos
source: 'auto_post_install'|'manual'|'review_form'
status: 'pending'|'approved'|'rejected' // moderation
installationJobId?: string // when auto-requested (7-day flow)
createdAt: Date
}
faq
faq { id; question: localized; answer: localized<richText>; category: string; order: number }
caseStudy
caseStudy {
id; slug; title: localized; summary: localized; body: localized<blocks>
system: { sizeKw?: number; products: string[] } // "projects we've done"
gallery: mediaRef[]; location?: string; status
}
banner / promo
banner { id; placement: string; image: localized<mediaRef>; link: string; campaignRef?: string; activeWindow: {from;to} }
Media
- Files in tenant object-storage bucket; Payload stores metadata + keys.
- Image variants generated for web performance.
Relationship to commerce
- Coupons referenced by
campaignRefmap to Medusa promotions (CMS holds the marketing page; Medusa holds the discount rule). - Reviews/testimonials may link to a verified
assetRef(Warranty).
Testimonial auto-collection (7-day flow)
installation.completed → delayed BullMQ job → notification → customer submits → testimonial created with source: 'auto_post_install', status: 'pending' → admin moderates → publish. See Eventing and Marketing module.
Access
Authoring via Payload admin (role: marketing_admin). Public reads via storefront, locale-aware, published-only.