User Manual For Website Editors and Administrators

Understanding Contentstack

All content of the website will be stored and maintained in a Headless Content Management System (HCMS), in our case in Contentstack.

A HCMS allows to define data structures and relations between datasets without any coding efforts. HCMS provide interfaces for creating, editing and maintaining datasets as well ass assets (files) and managing different permissions of the HCMS. Different to a classical CMS, like e.g. WordPress, a HCMS aims at being flexibly adaptable to many different purposes and even quite complex processes.

With the advantages, a few issues come: HCMS interfaces are not explicitly optimized to a defined specific processes. Sometimes you have to add a few clicks more. Basically, if you once understood the principle, working with a HCMS is comfortable.

With Contentstack comes a complete customizable user interface to allow to maintain content without any coding skills. Nevertheless, it helps to understand the key terms used in Contentstack and what relational data management means.

Relational Data Management

If you want to manage a huge amount of data, like e.g. for a website, and think about the different kinds of data, you will see that recurring patterns can be identified.

Simple example: every single page of a website consists of a header, a navigation, a footer and main content. Most of the elements are similar or identical on most of the pages, just the main content differs from one page to the other. If you define one data pattern to manage all data of all elements in one, you will see that you end up in a huge table which is hardly maintainable and in most of the table fields you will find the same values. To e.g. change a simple phrase in the footer, you have to update a lot of datasets in the table. This is tedious and even risky.

If you organize the data relational, you organize the fields in multiple tables, e.g. one for the navigation, one, for the main content etc. Then you also create an additional element where you just define, which dataset from the navigation table, which from the footer table, which from the main content table etc. should be used for a specific page. You define relations.

This is what you basically do in Contentstack, when you create a new page.

Contentstack HCMS Terms

In Contentstack, you work with such a relational data management.

  • A relation between two datasets is called Reference. Depending on the Content Type settings, you can reference datasets from one or multiple specific Content Types.

Using References is a key in using Contentstack. A comprehensive description how to work with References and what you need to consider, you can find in https://freshcells.atlassian.net/wiki/spaces/MEFAUM/pages/2532933791.

  • A Content Type is like a table in Contentstack, coming with a customized edit form.

  • With the edit form of a Content Type, you can create or edit an Entry, which is a dataset.

  • An Asset in Contentstack is a file you upload to Contentstack, like images, PDFs etc.

Please find more terms in the Glossary.

Be careful with deleting entries in Contentstack.

Many Content Types allow relations to others. This means that if you delete an entry, you might break web pages! If you do not need an entry any longer at a specific point, you should always just change the referenced entry.

Before you delete an entry, you should safeguard, if the entry is in use somewhere.

  1. Search the entry and open the detail view

  2. Open the entry Information at the right (see “Change or edit a referenced entry” below) and check the “Referenced in” information

If you see any referenced entry here, you should better avoid deleting an entry.


Please refer to the Contentstack User Manual for more detailed information about Contentstack.