Add Metadata to a Basic Page

The Page Metadata feature on Basic Page allows you to control what image and text is featured in Lists Paragraphs and Teasers. It is also used by social sharing applications, on-site search, and external search. Page Metadata does not appear on the page itself. 

Other content types (Events, News, etc) rely on structured data for a featured image and teaser text in lists and teasers. Basic Pages, by contrast, are very flexible and therefore do not have a predictable set of fields, and the metadata is used to display instead.

Add a Page Image and add a Page Description 

The Page Image and Page Description are accessed at the bottom of the edit page for a Basic Page.

1. Edit a Basic Page
2. Scroll down to Page Metadata
3. Under Page Image, click the Add Media button and select an existing image or upload a new image

4. In the Page Description field, enter a brief description of the page (up to 255 characters)
    

   
5. Click Save. 

How Page Image and Page Description are used 

On your site

On your site, the image and description will be used in the following places:

• Lists Paragraph - Basic Page Default List and Card Grid
• Teaser Paragraph when selecting a Basic Page
• On-site search results

Including the Page Description is an accessibility best practice for Lists and Teasers paragraphs. Without it, Siteimprove reports Content missing after heading.  

Beyond your site

Your page metadata may also show up in external services, including:

• Google, Bing, DuckDuckGo and other search results
• When sharing links in Slack
• When sharing links on social platforms like Bluesky, LinkedIn, and others

Add a Basic Page Type

Setting a Basic Page Type allows you to create lists of pages based on categories. For example, you could create a Basic Page Type called “Research Project,” then add a list of pages using that identifier to any page. 

Add Basic Page Type terms to your site

If you haven't already, create categories and labels for Basic Pages start by adding terms. See Basic Page Type vocabulary set.

Add a Basic Page Type to your page

1. Edit your Basic Page
2. Scroll down to the Page Metadata
3. Click on the Basic Page Type drop-down menu and select the appropriate term(s). You may add one or more terms

4. Click Save.