Shop It Docs
Developer ResourcesContent

Content Module Feature List

IT Mart CMS page and section coverage for admin, public, and mobile content APIs.

Content Module - Feature List

Purpose

The Content module provides an IT Mart CMS layer for editorial page copy. It does not replace existing feature APIs for products, categories, brands, reviews, blogs, FAQs, repair requests, or care packages.

Live frontend pages already consuming CMS:

  • about
  • faq
  • privacy_policy
  • terms_of_service

Target CMS pages for frontend adoption:

  • home
  • global_footer
  • digital_products
  • repair
  • itmartcare
  • itmartcare_claim
  • itmartcare_detail
  • categories
  • brands
  • articles

Supported API Features

FeatureEndpointNotes
Admin page readGET /api/admin/content/pages/:pageKeyAuto-creates missing valid page
Page metadata updatePATCH /api/admin/content/pages/:pageKey/metaTitle and optional SEO link
Section upsertPUT /api/admin/content/pages/:pageKey/sections/:sectionKeyStrict page-aware payload validation
Section deleteDELETE /api/admin/content/pages/:pageKey/sections/:sectionKeyRequires existing page and section
Public page readGET /api/content/pages/:pageKeyEnabled sections only
Mobile page readGET /api/mobile/content/pages/:pageKeySame contract as public read

Admin write operations purge both admin and public Redis page caches and trigger frontend revalidation tags.

Page Coverage Matrix

Page keyRouteCMS-owned sections
home/new_arrivals, trending, popular_picks, categories, itmart_care, brands, trusted_partner, repair_process, customer_reviews, tech_articles
about/abouthero, quote, story_blocks, why_choose, faq_intro, blogs
faq/faqfaq_intro
privacy_policy/privacy-policydocument
terms_of_service/terms-of-servicedocument
global_footersite-wide footerbrand_blurb, quick_links, legal_links, copyright
digital_products/digitalproductshero, product_listing
repair/repairhero, steps, upsell_promo
itmartcare/itmartcarehero
itmartcare_claim/itmartcare/claimclaim_steps
itmartcare_detail/itmartcare/[slug]before_you_continue, fallback_description
categories/categorieshero
brands/brandshero
articles/articleshero

Home Page Sections

CMS owns only heading, description, CTA, and related editorial copy. Product, category, brand, review, and article listing data remains backend-driven by feature APIs.

SectionPayload
new_arrivalsheading, description, ctaLabel
trendingheading, description, ctaLabel
popular_picksheading, description, ctaLabel
categoriesheading, description, ctaLabel
itmart_carebadge, description, ctaLabel, logo, benefits[]
brandsheading, description, ctaLabel
trusted_partnerheading, description, ctaLabel, image
repair_processheading, description, ctaLabel, steps[]
customer_reviewsheading, description, ctaLabel
tech_articlesheading, description, ctaLabel

About Page Sections

SectionPayload
herolabel, heading, subtitle, description, images.main
quotelabel, text, author, authorTitle
story_blocksblocks[] with image, label, heading, tagline, description, bullets[]
why_chooselabel, heading, description, cards[]
faq_introlabel, heading, description
blogsenabled/disabled toggle only; payload is {}
PageSectionPayload
faqfaq_introlabel, heading, description
privacy_policydocumenteyebrow, title, summary, lastUpdated, sections[]
terms_of_servicedocumentsame as privacy_policy.document

These live pages keep their current frontend fallback model.

Commerce and Service Pages

PageSectionPayload
digital_productsheroheading, description
digital_productsproduct_listingheading
repairheroheading, description
repairstepssteps[] with { id, image, step, title }
repairupsell_promotitle, ctaLabel, href
itmartcareherologo, description, shieldImage
itmartcare_claimclaim_stepspickupDropSteps[], inStoreSteps[]
itmartcare_detailbefore_you_continueheading, steps[]
itmartcare_detailfallback_descriptiontext

Care plan names, prices, features, and coverage come from the care-package API, not CMS.

Listing Shell Pages

PageSectionPayload
categoriesheroheading, description
brandsheroheading, description
articlesheroheading

Category grid data comes from the categories API. Brand grid data comes from the brands API. Article carousel and grid data come from the blogs API.

SectionPayload
brand_blurblogo, heading, description, contacts[]
quick_linkscolumnHeading, columns[] with nested links[]
legal_linkslinks[]
copyrighttext

Cache and Revalidation Features

OperationRedis purgeRevalidation tags
Page meta updateadmin + public page key patternscontent:page:<pageKey> plus shared page tag
Section upsertadmin + public page key patternscontent:page:<pageKey> plus shared page tag
Section deleteadmin + public page key patternscontent:page:<pageKey> plus shared page tag
Manual content purgeselected content Redis scopesupplied admin tags

Shared page tags are IT Mart-specific, such as page:digital-products, page:repair, page:brands, and layout:footer.

Completion Checklist

  • IT Mart page keys are the only valid CMS page enum values.
  • Retired copied product page keys are removed from the API enum.
  • Section compatibility is enforced by page.
  • Reused hero keys validate with page-specific payload schemas.
  • Admin writes purge admin and public read caches.
  • Content write hooks trigger frontend revalidation tags.
  • Fumadocs documents the IT Mart CMS contract.

See Also