Creating a Configuration Headless Quick Start Guide

Last update: April 11, 2024

CREATED FOR:

  • Admin
  • Developer

As a first step to getting started with headless in AEM 6.5, you need to create 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.

NOTE
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

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 and from the main menu select Tools > General > Configuration Browser.

  2. Provide a Title for your configuration.

    • A name will be automatically generated based on the title and adjusted according to AEM naming conventions.. It will become the node name in the repository.

  3. Check the following options:

    • Content Fragment Models
    • GraphQL Persistent Queries

    Create Configuration

  4. Click Create

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

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

Next Steps

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

Experience Manager


Put the Customer at the Center and Build Relationships That Last a Lifetime

Online | Strategy Keynote | General Audience

First impressions last a lifetime. Great first impressions feel personal, connected, and relevant right from the start. From the first...

Wed, Mar 19, 2:30 PM PDT (9:30 PM UTC)

Register

The True Cost of a Failed Implementation

Online | Session | General Audience

A failed implementation isn’t just an inconvenience — it costs real revenue. Poor execution and misaligned tools disrupt pipelines,...

Wed, Mar 19, 2:00 PM PDT (9:00 PM UTC)

Register

Connect with Experience League at Summit!

Get front-row access to top sessions, hands-on activities, and networking—wherever you are!

Learn more

Register now