Headless CMS Playbook
  • Headless CMS Playbook | Rangle.io
  • Introduction
    • What is a headless CMS?
    • Benefits of a headless CMS
    • Headless architecture
  • Headless CMS tools
    • What to consider when choosing a headless CMS
    • Sanity: Most customizable
    • Contentful: Best for enterprise
    • Stackbit: Best visual editor
    • Strapi: Budget-friendly self-hosted
    • Honourable mentions
    • Choosing the best headless CMS for you
  • Authoring experience
    • Assessing capabilities and needs
    • Trade-offs
    • Best practices
    • Live preview
  • Content modelling
    • Understanding content models
    • Best practices for content modelling
    • Querying content
  • Static site generators
    • Comparing different build options
    • Popular static site generators
    • Component library
    • How to connect content data to front-end components
  • Conclusion
    • Key takeaways
    • Subscribe
    • More resources
  • Author acknowledgements
Powered by GitBook

Rangle.io

On this page
  • Flexibility
  • Content fields
  • Pages

Was this helpful?

  1. Authoring experience

Trade-offs

PreviousAssessing capabilities and needsNextBest practices

Last updated 2 years ago

Was this helpful?

Flexibility

When designing the authoring experience for a CMS platform, it's crucial to consider the appropriate level of flexibility to provide content authors. There's a balance between flexibility and usability that should be carefully weighed. Overloading users with unnecessary choices can complicate their workflows and make it harder for authors to create pages with a consistent brand aesthetic.

What kinds of components and layouts will users need to build? Providing flexibility where users need it – and hiding choices where they don't – is key to building a coherent authoring experience.

Content fields

When building text input fields, we recommend thoughtfully selecting what text styling options are shown to users, instead of showing every possible styling option. In some cases, it may make sense to provide a simplified text area and specify font styles in the front-end code. This helps avoid inconsistencies and hierarchy issues.

For example, perhaps your content authors need to bold, italicize, or hyperlink parts of an image caption, but they don't need to change the font size or add bullet points. In that case, it makes sense to hard code the font size in the component and declutter the user interface.

Pages

Starting with a blank page can be daunting for content authors. They may not know what the page should look like or what components to use. Rather than requiring content authors to make design decisions every time they build a page, it may be helpful to provide a template.

For example, blog posts on our website are templated. Content fields are mapped to predetermined components to limit what page modules authors can add, edit, or move on the page. The page layout can only be modified by chancing code. The CMS essentially acts as a content database.

Some pages require a tad more flexibility. For example, our careers page has a templated section and another section where authors can add page modules from a list of options.

More advanced content authors may need to assemble entire pages from scratch. For example, they may need to create product pages with unique page layouts and A/B test which variations convert better.

Rather than making every component available for use, however, we recommend delimiting which components can be used on a given page type. This helps standardize how the pages look and feel and declutter unnecessary components in the page content model.

We'll discuss when to template pages and how much flexibility to provide when architecting page layouts in the .

content modelling section
On the left, users see a minimalistic text box for entering image caption; they see options to bold, italicize, and hyperlink text. On the right, users see a cluttered text box for entering image caption; they see a drop-down menu for selecting a font size, and options to bold, italicize, itemize, and hyperlink text.
Our blog posts use templated pages. Users can write and edit content in predefined fields.
Authors can add page modules to the non-templated section of a hybrid page.
Authors can add and move page modules and customize the layout of a non-templated page.
On the left, users see a minimalistic text box for entering image caption; they see options to bold, italicize, and hyperlink text. On the right, users see a cluttered text box for entering image caption; they see a drop-down menu for selecting a font size, and options to bold, italicize, itemize, and hyperlink text.