---
canonical: https://amplience.com/developers/docs/release-notes/2026/hierarchy-api-preview/
title: Using the Hierarchy API in content previews
description: This release allows you to use the Hierarchy API in content previews
audience: Business User
image: https://cdn.media.amplience.net/i/ampproduct/hierarchy-api-preview-1?w=1200&h=630
image_width: 1200
image_height: 630
date_published: 2026-05-11
date_modified: 2026-05-11
---

# Using the Hierarchy API in content previews

**Release date: 13th May 2026**

In this release we’ve made some changes to allow you to use the [Hierarchy API](https://amplience.com/developers/docs/apis/content-delivery/hierarchy-api/) in [content preview apps](https://amplience.com/developers/docs/dev-tools/guides-tutorials/content-previews). You can now preview your site at a specified time and date in the future, and make use of the features of the Hierarchy API to retrieve upcoming updates to page structures, site maps and other content modeled using [hierarchies](https://amplience.com/developers/docs/dev-tools/guides-tutorials/hierarchies/).

You can also use the Hierarchy API with the [preview edition](https://amplience.com/developers/docs/user-guides/schedule-content/preview/#previewing-unscheduled-content) feature. This allows you to preview the content of an individual edition alongside published content, without first having to [schedule the edition](https://amplience.com/developers/docs/user-guides/schedule-content/schedule-edition). This further enhances the workflow for your content creators and planners.

> **Note: Hierarchy preview support in beta**
> Preview support for the Hierarchy API is currently in beta and we have some [guidelines](https://amplience.com/developers/docs/apis/content-delivery/hierarchy-api/#using-the-hierarchy-api-for-content-previews) to optimize performance.

## Content preview example

In this example we've scheduled an edition containing updates to our site hierarchy and list of store locations.

The user chooses a date and time from which to preview their content and the preview app is launched. The preview app uses the Hierarchy API to return the site menu content that is [scheduled](https://amplience.com/developers/docs/user-guides/schedule-content/schedule-edition) to be published on the date and time chosen by the user. The hierarchical content will appear in the preview exactly as it will when all the content is published.

![Previewing an edition containing hierarchical content at a specified date and time](https://cdn.media.amplience.net/i/ampproduct/hierarchy-api-preview-1?w=1880&fmt=png 'Previewing an edition containing hierarchical content at a specified date and time')

### Content previews and virtual staging

The URL shown in the image above is a virtual staging URL and it's passed to your content preview app. Encoded within the URL is the date and time selected by the user. The URL is used in place of the production content delivery URL to retrieve content that is scheduled to be published at the specified time.

Virtual staging allows you to use the same code for your preview apps as you do for your production site. Because you can now make use of all the features of the [Hierarchy API](https://amplience.com/developers/docs/apis/content-delivery/hierarchy-api/#using-the-hierarchy-api-for-content-previews), the user experience will be the same for your content previews as it will be when all your scheduled content goes live.

You can find out more about how previews use virtual staging in [Dynamic Content and Virtual Staging](https://amplience.com/developers/docs/dev-tools/guides-tutorials/virtual-staging/virtual-staging-dynamic-content/#dynamic-content-and-virtual-staging) and the [Creating content previews](https://amplience.com/developers/docs/dev-tools/guides-tutorials/content-previews) page.

## Related pages

[Hierarchies](https://amplience.com/developers/docs/dev-tools/guides-tutorials/hierarchies/)

[Hierarchy API](https://amplience.com/developers/docs/apis/content-delivery/hierarchy-api/)

[Using the Hierarchy API in content previews](https://amplience.com/developers/docs/apis/content-delivery/hierarchy-api/#using-the-hierarchy-api-for-content-previews)

[Developing content preview apps](https://amplience.com/developers/docs/dev-tools/guides-tutorials/content-previews)

[Preview apps and virtual staging](https://amplience.com/developers/docs/dev-tools/guides-tutorials/virtual-staging/virtual-staging-dynamic-content/#dynamic-content-and-virtual-staging)