Creating a Configuration - Headless Setup creating-configuration

As a first step to getting started with headless in AEM as a Cloud Service, you need to create a configuration.

What is a Configuration? what-is-a-configuration

The Configuration Browser provides a generic configuration API, content structure, resolution mechanism for configurations in AEM.

In the context of headless content management in AEM, think of a configuration as a workplace within AEM where you can create your Content Models, which define the structure of your future content and Content Fragments. You can have multiple configurations to separate these models.

If you are familiar with page templates in a full-stack AEM implementation, the usage of configurations for the management of Content Models is similar.

How to Create a Configuration how-to-create-a-configuration

An administrator would only need to create a configuration once, or very seldomly when a new workspace is required for organizing your Content Models. For the purposes of this getting started guide, we only need to create one configuration.

  1. Log into AEM as a Cloud Service and from the main menu select Tools > General > Configuration Browser.

  2. Provide a Title and a Name for your configuration.

    • The Title should be descriptive.

    • The Name becomes the node name in the repository.

      • It is automatically generated based on the title and adjusted according to AEM naming conventions.
      • It can be adjusted if necessary.
  3. Check the following options:

    • Content Fragment Models
    • GraphQL Persisted Queries

    Create Configuration

  4. Select Create

You can create multiple configurations if necessary. Configurations can also be nested.

Configuration options in addition to Content Fragment Models and GraphQL Persisted Queries may be necessary depending on your implementation requirements.

Next Steps next-steps

Using this configuration, you can now move on to the second part of the getting started guide and create Content Fragment Models.

For complete details about the Configuration Browser, see the Configuration Browser documentation.