Create a Map

A map is an organizational tool that lets you add and organize information in a hierarchical structure. This tasks shows you how to create a map and organize content in the map.

You can download example DITA files from here:

Upload map components

If desired, you can upload local sample files into AEM for a more complete set of materials.

  1. Drag and drop any local files into AEM to upload them.
  2. Repeat as needed for any files, including images and topics.

Create a map

  1. To open the Options menu, select the ellipsis icon on your main folder .

    Ellipsis icon

  2. Select Create > Map.

    Create map

    The Create New Map dialog displays.

  3. In the Template field, select Bookmap from the drop-down menu and give your map a title.

  4. Select Create.

    Your map is created, and the left rail automatically changes from the Repository view to the Map view.

Insert map components

  1. Select the pencil icon in the left rail.

    Edit icon

    This is the Edit icon, and allows you to open the map in the editor.

  2. Switch back to Repository view by selecting the Repository icon.

    Repository icon

  3. Add a topic to the map by dragging and dropping it from the Repository into the map in the editor.

    The line indicator shows you where your topic is placed.

  4. Continue to add topics as needed.

View a map preview

Preview provides a quick look at the content using default formats. It displays the headings, paragraphs, lists, and any other content in the topics is shown.

  1. Select Preview from the top black menu bar.

    Preview button

Your content opens in Preview.

  1. To return to Author View and resume map editing, select Author.

    Author button

Configure map structure

You can edit the hierarchy of topics inside the map.

  1. Click a topic’s icon to select it.

  2. Use the arrows to demote and promote elements respectively.

    Repository icon

Save the map as a new version

Now that the map is complete, you can save your work as a new version and record your changes.

  1. Select the Save as New Version icon.

    Save as New Version icon

  2. In the Comments for new Version field, enter a brief but clear summary of changes.

  3. In the Version Labels field, enter any relevant labels.

    Labels allow you to specify the version you want to include when publishing.


    If your program is configured with predefined labels, you can select from these to ensure consistent labelling.

  4. Select Save.

    You have created a new version of your map, and the version number is updated.

On this page