Component Naming Conventions for a CMS Website: A Practical Guide for Digital Teams

Hello Digital Team,

I am sure everyone of us has faced this moment. You are building a CMS component library, you have a beautiful design file on one screen and the CMS admin on the other, and you are stuck on one small thing: what do we actually call this thing?

A week later the content author opens the CMS, scrolls a list of forty components, and cannot find the one they need. Small naming decisions become big authoring problems. A tiny card variation ends up as “Card Block” and “Card Block New”, and now nobody knows which to use. This is the practical playbook I have used on Optimizely, Sitecore, and headless builds over the last twelve years, written for the developers, designers, and PMs setting a library up or cleaning one up.

The library at a glance. Most CMS libraries are these shelves. The names in bold are the plain, author-first labels I use.

  • Global (kept out of the picker): Top Navigation, Footer, Cookie Consent Banner, Announcement Bar
  • Hero: one Hero, with layout and media as options
  • Content blocks: Rich Text, Two Column Text, Text and Image, Text and Video, Quote, Callout
  • Cards: Card Grid + Card
  • Media: Image, Video, Image Gallery, Logo Strip
  • Call to action: CTA Banner, CTA Card
  • Interactive: Accordion, Tabs, Timeline, Stats, Testimonial
  • Listing: Article Listing, Event Listing, Related Content

Want the full picture? The CMS Component Index Drawing Set draws all 162, labeled by scope.

Read More