Skip to main content

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 { 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 campaignRef map 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.