Organizing Pages creating-and-organizing-pages

Learn how to organize your website with AEM. Once you understand how you need to organize your pages, you can create new pages and manage exiting pages.

[For authoring AEM content for Edge Delivery Services, click here.]{class="badge positive" title="Authoring AEM content for Edge Delivery Services"}

Organizing your Site organizing-your-site

As an author, you need to organize your site within AEM. This involves creating and naming your content pages so that:

  • You can easily find them on the author environment
  • Visitors to your site can easily browse them on the publish environment

You can also use folders to help organize your content.

The structure of a website can be thought of as a tree that holds your content pages. The names of these content pages are used to form the URLs, whereas the titles are shown when the page content is viewed.

The following shows an example from the WKND Tutorial site, where an article about skateparks (la-skateparks) is accessed:

http://<host>:<port>/editor.html/content/wknd/en/sports/la-skateparks.html

 /content
 /wknd
  /en
   /music
    /...
   /sports
    /la-skateparks
    /five-gyms-la
    /mountain-bike-routes
   /shopping
    /...
   /art
    /...
   /...

This structure can be viewed From the Sites console, where you can navigate through the pages of your website and perform actions on the pages.

Page Naming Conventions page-naming-conventions

When creating a page there are two keys fields:

  • Title:

    • This is displayed to the user in the console and shown at the top of the page content when editing.
    • This field is mandatory.
  • Name:

    • This is used to generate the URI.
    • User input for this field is optional. If not specified, the name is derived from the title. See the following section Page Name Restrictions and Best Practices for details.

Page Name Restrictions and Best Practices page-name-restrictions-and-best-practices

The page Title and Name can be created separately but are related:

  • When creating a page, only the Title field is required. If no Name is provided at page creation, AEM will generate a name from the first 64 characters of the title (observing the validation set out below). Only the first 64 characters are used to support the best practice of short page names.
  • If a page name is manually specified by the author, the 64 character limit does not apply, however other technical limitations on the page name length may.
TIP
When defining a page name, a good rule-of-thumb is to keep the page name as brief but as expressive and memorable as possible to make it easy to understand for the reader. See the W3C style guide for the title element for more information.
Also keep in mind that some browsers (for example, older versions of IE) can only accept URLs up to a certain length, so there is also technical reason to keep page names short.

When creating a page, AEM validates the page name according to the conventions imposed by AEM and the JCR.

The minimum allowed characters are:

  • a through z
  • A through Z
  • 0 through 9
  • _ (underscore)
  • - (hyphen/minus)

Full details of all characters allowed can be found in the naming conventions.

NOTE
Page names are limited to 150 characters.

Title title

If you supply only a page Title when creating a page, AEM derives the page Name from this string and validate the name according to the conventions imposed by AEM and JCR.

A Title field containing invalid characters is accepted, but the name derived has the invalid characters substituted. For example:

Title
Derived Name
Schön
schoen.html
SC%&*ç+
sc---c-.html

Name name

When you supply a page Name when creating a page, AEM validates the name according to the conventions imposed by AEM and JCR. You cannot submit invalid characters in the Name field. When AEM detects invalid characters, the field is highlighted with an explanatory message.

Example of entering an invalid page name

TIP
You should avoid using a two-letter code as defined by ISO-639-1 as a page name, unless it is a language root.
See Preparing Content for Translation for more information.

Templates templates

In AEM, a template is a specialized type of page used as the basis for any new page being created.

The template defines the structure of a page including a thumbnail image and other properties. For example, you may have separate templates for product pages, sitemaps, and contact information. Templates are comprised of components.

AEM comes with several templates provided out-of-the-box. The templates available depend on the individual website. The key fields are:

  • Title - The title displayed on the resulting web-page
  • Name - Used when naming the page
  • Template - A list of templates available for use when generating the new page

Components components

Components are the elements provided by AEM so that you can add specific types of content. AEM comes with a range of out-of-the-box components, called the Core Components, that provide comprehensive functionality. Some examples of the components are:

  • Text
  • Image
  • Title
  • Carousel
  • And many more

Once you have created and opened a page you can add content using the components, which are available from the component browser.

TIP
The Components Console give an overview of the components on your instance.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab