Adding a new page

December 21, 2021

Through jContent and PageComposer Jahia provides the ability to create, edit, and maintain web pages as part of the digital experience platform. This tutorial guides you through creating a page, adding different types of content to it, previewing the page, and finally publishing your new page.

Before you begin

 Whether you are in our free cloud trial, or working in a system you have deployed, there are a few things you’ll need to get started:

  1. Access to a deployed Jahia system, in your own environment or on our Cloud trial system
  2. User id and password with permissions to edit content and personalization.
  3. At least one template set and some images, we provide these with our demo installer as well as in our free cloud trial environment.

Ready to begin?

For detailed instructions on getting started visit the Getting Started with Jahia Tutorials page.

What you will learn

  • How to create and add a basic page to a site.
  • Add basic content - rich text and image.
  • How preview mode can be used to view the site on different devices.
  • Successfully publish new content and pagespage.
  • How to use jContent and Page Composer.


Helpful terms

  • Page Composer
    Is the application you use to create and edit content in pages on your site. Each page includes a combination of content, areas and layout that are specified by the template you chose (based on your permissions). Use Page Composer to see all the pages that are part of your tutorial project.
  • Content Editor
    Lets you create content and publish it to sites or applications. Content can refer to rich text, images, files and dynamic page elements like navigation bars and lists. In this tutorial you will create a page using templates and content types available in the trial system.
  • Template
    A template is a model used to set up the layout of elements on pages, including headers, footers, menus and breadcrumbs that will appear on all pages.
  • Component
    A type of Jahia module that describes the structure of a content type, what types of content it can display and how it will be displayed.
  • Content
    Rich text, images, files, and dynamic page elements like navigation bars and lists.

Creating and configuring a new page

In Jahia a page is a type of content, it always needs a title and a template to set the layout. Let’s start off by creating a new page in page composer.  Using the left navigation, click the 

icon.  Page Composer will open.

Create a new page

  1. expand the site tree until you see the Home page in the tree.
  2. Click the ellipsis (...) to the right of the Home page.
  3. Select New page item from the flyout menu.

expand page tree

A new Create Page pane will appear, this pane is also referred to as the Content Editor. From the Create Page pane you can set some simple properties for your new page.

Create page

Configure your page

  1. System Name: This is used to build the page URL, it is automatically created from the page title by default, but can be modified although for the purpose of this tutorial you do not need to change it.
  2. Title:eg. Write ‘My First Page’.
  3. Template: Select a template from the choices available to set your page layout, click save to see a preview in Content Editor.
    create a page.PNG

Note that the title of the pane has changed to the title of your page.  The preview you see at the right is displayed based on what has been defined in your template, once you add additional content components like text or images the view will become more interesting.

Explore the Content Editor interface. There are additional options available in Content Editor that go beyond the basic page properties, custom fields can be created and added by modules from either Jahia or by you! One such example is Add Interests Values, this option is only present when you have added the jExperience module to your project.  Learn more about interests here: Adding Interests to Pages

Finish creating your new page

The status of your page is visible in the upper right corner, indicating the type of content language of the content edited, the publication status and the saved status. Click Save.



*Note: If you see an exclamation badge on the save button please review your inputs to make sure they are all valid.

You should now see a preview summary of all the properties you have set for your new page:

my first page.PNG

Return to page composer you can click the back button located left of yourtitle  in the header.


Now select “My First Page” at the bottom of the site tree.

Congratulations!  You have created your first page.

Adding content to a page

Once the page is created and you’ve returned to Page Composer, you may notice that the new page already includes elements like a site logo and a navigation menu at the top or footer links at the bottom. Any elements that were added to the page automatically are configured as part of the template that you selected when you created the page.


The page template you selected earlier will have defined areas of the page where additional components or content can be created. A component can be added by clicking on the Any content button in the editable area.

Note: The page properties (such as the page template) can be modified or edited after creating the page. You can do this on any page in the site tree by right clicking on the ellipses (...) and select Edit item from the menu. Additionally, you can edit a page’s properties through the Page Options menu found in the vertical ellipsis in the header / right of the publish button.

Adding Content Components

In the Page Composer pane, hover over the available areas until you see a + Any content or + Add component button

  1. Click the + Any content  button to display the SELECT CONTENT TYPE dialog.

    The component dialog provides a list of components that can be added into the area. The components available will vary from one template set to another, you may have to add a layout element before you add a text or image component. Some examples of available components can include:
    • Structured content: news or person
    • Unstructured content: rich text, images
    • Presentation elements: carousels or sliders
    • Layout elements: sections, rows, and columns
    • Other types: web forms, search boxes, etc.
  2. Add a text content to the page, if one is not available add a layout component or other component that will allow text content to be added. You can find components quickly by typing in the search bar. For example type "text".

Add a Text component

  1. Select the component of your choice and click Create.  For this tutorial based on the Jahia Base Demo Templates choose Rich text. Similar to when you created a new page, the Content Editor displays and lets you edit the fields and properties of the Text component that you just selected. 
  2. Add text, you can copy and paste the text here, or type your own. 
    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum porta feugiat felis, vel sollicitudin lorem faucibus nec. Quisque et pulvinar ante, in volutpat lacus. Pellentesque porttitor fermentum consequat. Sed hendrerit in lectus eu efficitur. Phasellus nec placerat turpis. Phasellus ac elit interdum, faucibus sem in, blandit massa. Pellentesque euismod sollicitudin neque, quis tincidunt justo ultricies non. Aenean sit amet sapien est. Nam rutrum elit risus. Mauris sed ante ac magna posuere egestas. Integer eu egestas diam. Curabitur nec nulla in quam molestie commodo. Sed ut nulla mattis, auctor libero at, sagittis metus. Quisque feugiat dapibus arcu. Quisque ut venenatis odio, id lobortis metus. Maecenas tempor non mi dapibus sollicitudin. Ut dui orci, ultricies non pretium et, suscipit et tortor. Pellentesque euismod tempus lectus, placerat aliquam justo efficitur quis. Pellentesque iaculis euismod risus sit amet ornare. Praesent vulputate ex aliquet ante facilisis mollis. Aliquam tempus lacinia erat, vel fringilla nunc aliquet eu.
  3. Format your text.  Many text components will allow you to format, add links, images and more. Try out some formatting and once you are satisfied, click Save. The Content Editor Preview will appear, click to return to the page composer

Adding a header image

To make it this page more interesting add an image header to the page. Repeat the steps from when you added the text component. 

  1. Click on the +Any content button on the page.
  2. In the Select Component Type dialog, search for Heading or Banner depending on your template components and choose one.
  3. Click Ok.

Configure the Header/Banner image

This component type usually includes two properties: image and text.  When working with the Banner component from Jahia Base Demo Templates the body property is a rich text field similar to the one you previously saw in the Text component. The image property allows you to select an image that is stored on the Jahia platform.


Adding an image from the jContent Media Library

The jContent Media Library lets you store the media you need for your websites and other content projects. You can store any kind of file in the library, including images, videos, and documents (such as PDFs and text files). While browsing for an image take note of the option to search available content and to upload new content.
  1. Click on ADD IMAGE in the image field to select an image for this field. This will open up the jContent Media Library.
  2. Navigate the hierarchy Digitall>images>banners
  3. Select an image from banners, or upload your own
  4. Add a title for your banner content, click SAVE 

Add text to the body field:

  1. Add the text “My First Page” - this will display over your image on the page
  2. Click Save to preserve your change.
  3. Check your preview results.
  4. Click the back arrow in Content Editor to return to Page Composer.



Congratulations! You now have an image as well as text displayed on your page

Change content layout

Building upon the previous steps, you will now use the drag and drop functionality to rearrange the components on your page. Drag and drop a component by:

  1. Hovering your mouse over the component you want to move.
  2. Notice the blue box that appears at the top left of the component.
  3. Click (and hold) on that blue box and move your mouse towards the area you want to move the component to.
  4. In the case of the Heading component, drag it just above or below the Text component. 

    You should see a green checkbox appear when the Heading component is dragged to a spot on the page where it can be dropped.

Previewing the page

Now that you have a complete page, it's time to preview to make sure that the page looks and behaves the way you intended. With Jahia’s Preview Mode, you have the ability to test your web pages to ensure they display correctly to your visitors.

To access Preview Mode, click on the Preview dropdown found at the top left of the page toolbar and click preview to open your web page in another browser window or tab.  This lets you see exactly how your page will look to the visitor once it’s published.


Note: Your browser might block popups to allow Preview Mode to allow popups for Jahia.

In Preview Mode, you can also navigate to other pages of your website, allowing you to fully test the entire site experience. 

Preview for other channels

Jahia’s Preview Mode also lets you test what your web pages will look like on mobile devices and other channels. To preview your page for various mobile device types:

  1. Return to Page Composer.
  2. Click the down arrow next to Preview in the page toolbar. This will display the Preview menu.
  3. Select the Customized preview option from the menu.

    There are several options you can use in order to test what the page might look like under different conditions. To preview your page for a mobile device:
    • Click into the Channel dropdown.
    • Select the device you’d like to test (for example, Phone: iPhone).
    • Set the orientation (Portrait or Landscape).
    • Click on the Show customized preview button.

In another tab or window, your web page should now be displayed in the device and orientation you selected.

Publishing the page

Now that you’ve verified that the page looks and behaves as intended, the last step is to publish the page to make it available to your website visitors. To begin the publishing process, click Publish Page found at the top right of the page toolbar.



Publication Dashboard

Clicking Publish Page will bring up the Publication Dashboard. This dashboard lets you start the workflow(s) required to review and publish the page.


The Publication Dashboard has three kinds of information

  • Action: An overview of the page and content being published
  • Comments: All comments and descriptions provided by users involved in the publishing process
  • Publication infos: a detailed view of all the content being published with the option to review individually and compare pages side by side.

To publish your page:

  1. Click on Action at the right:
    • In the top line you will see <status indicator and text > : <number of items> similar to:
      This indicates whether the page has even been published and how many content items are in the page.
      Note: the number of items will depend on the template you have chosen for your page.
    • Click on the Title field and replace it with “Publish My First Page”. This is the title for the publication request and is important to track your changes over time and to communicate with others who may share your project.
  2. Click on Comments: When working alone, or with a team, it can be helpful to add notes to the pages you are working on. Comments provide a space for you, your collaborators and reviewers to describe and converse about changes made, required, rejected etc.
    • Type in a comment and click ADD COMMENT
  3. Click on Publication Information and click to expand the list. This section provides a detailed list of the items being published. Items in the list may have additional buttons.
    • Compare - Allows you to do a side-by-side comparison with previous versions - it isn’t applicable if you haven’t published before.
    • Publication review - Takes you back to the Content Editor view.
  4. Click the Publish button - a notification will appear in the bottom left corner while the page is publishing. You will be returned to Page Composer where you will be able to see that the page has been published by looking at the Published status in the upper right corner.

Note: More complex scenarios can be implemented when working with teams that include other contributors, translators, reviewers etc. To learn more go to validating and reviewing workflows.

View your Live page

  1. To access Live page view click the dropdown arrow to the right of preview.
  2. Select Live> Open in the new window.
Congratulations! Your first Jahia web page should now be available. To continue learning check out Adding Personalization