Please follow the checklist below to complete your page.

1. Check your page name, URL, HTML title, meta description and icon image

These features are crucial to the functioning of your page. You can add and update them using by clicking on the 'configure' cog icon: 


How to manage your page data

2. Resize and rename your image files

Then add them to the correct folder in the documents and media library. These are the most used image dimensions:

  • Section header: 1440 x 810 pixels
  • Page icons and call to action images: 764 x 540 pixels
  • List images: 382 x 270 pixels

Remember also to add an alternative description to any images you use in the page. 

How to use images on


3. Paste in plain text and use the Liferay tools to apply formatting

Please paste in plain text every time you update some content. Copying and pasting directly from a Word document, email or website usually carries across hidden code that can make your pages display and function incorrectly across different browsers and devices. 

You can use the 'Paste as plain text' tool to do this:  

Think of your page text visually: it’s good to use shorter paragraphs online (up to 3 sentences each), separate them with subheadings (see below), use bullet points for lists, etc.

4. Apply subheading and ‘intro’ formatting to your text

This makes your content easier for people and search engines to read. We need to do this to make the page accessible and SEO-friendly - don't use bold text as a substitute for Liferay's own formatting options.

The main styles we use on the page are: 


Heading 3 (for subheadings)

Heading 4 (for sub-subheadings)

Writing and formatting guidance

5. Use meaningful link titles, and link to relevant internal and external content

All link titles must be meaningful in their own right, so we can meet our legal accessibility requirements. 

  • We never make a text link called click herehere or page
  • We give each text link a meaningful and unique title that makes clear what you're about to click on (e.g. Website and Portal Support team pages)
  • We never use URLs as link titles - always use meaningful text instead

Top tips: 

  • Make sure to link out from your pages content to as many relevant internal and external pages as you can. This gives people a good user experience and encourages them to spend more time on our site.
  • For 'call to action' links, we enter the width 300px, as this works best across different contexts. If your link text is long, you can use a soft return midway through to make it run over two lines. 
  • Set external links to open in a new window, using the 'target' tab in the link creator.

How to link effectively

6. Navigation and user journey

  • Check that any left-hand navigation block is set at the correct level of the site structure (usually matching the final link on the breadcrumb)
  • Check also that image link navigation blocks show the pages you’d like to appear there, with the destination page’s icon image displaying.
  • Make the next steps/onward journey clear and easy to spot. 

How to use page features

7. Check your page in mobile and tablet views

Check that your page content displays and works well across different devices.

  • Can you read the heading and scan-read the page content easily?
  • Does the image still display well and communicate its message? 
  • Does the page take a long time to load? 

The look will define the user experience, and the page load speed in particular will influence our overall ranking in search engines.

Simply changing the dimensions of your browser gives you a quick idea of how your page might look on phones or tablets. To check with more accuracy, we recommend using the free device simulator in Chrome.

8. Add your new page to the tracker

We keep a record of all the core pages on the public website, including details of who owns and/or edits them and a date for review. Please add the details of your new page to our tracker. 

How to update the tracker