Agility CMS documentationAgility CMS documentation
OverviewEditorsDevelopersOwners & AdminsTraining GuideApps
Sign inLet's Chat
Developers
Content-first ApproachContent ModelsComponent Models FieldsLinked Content Field TypesGetting Started with Linked ContentSitemapsPage ModelsSetting Up PreviewHandling Agility URLsDeployment & Code RepositoriesTagging Content in AgilityManaging SEO for DevelopersMastering Nested Linked Content in Agility CMS: Enhance Hierarchical Data ManagementAdvanced Field Validation with Regular ExpressionsDynamic Content Control: Implementing Hide/When Formulas in Your Headless CMS Content ModelGrouping Components into Tabs, Accordions, and SectionsConditional & Cross-Field Validation

Content Architecture

Sitemaps

Manage one or more content destinations and the pages within them.

What are Sitemaps and why are they important?

In most cases, a Sitemap represents a Website. Sometimes called a Page Tree, the Sitemap is a blueprint of your website's architecture. An instance in Agility can have either a single Sitemap or multiple. 

Sitemaps allow Editors to manage multiple content destinations within a single Instance. A content destination can be considered a website, application, digital signage, etc. where Editors can manage the pages and module components that make up the front-end of their digital solution. 

Accessing Sitemaps

In Agility you can find your Sitemaps and Pages within the Pages Section. At a glance, you can see your Sitemap(s), which pages are within each Sitemap, and you can tell where each page is and how it relates to other pages around it. This shows the hierarchy of the pages as they will appear on the front-end of your digital solution. 

Sitemap Configuration

Sitemaps in Agility are typically associated with one or more deployments. For example, you may have your Production environment as well as a Preview deployment under preview.mysite.com. 

When setting up a Sitemap for the first time, or adding a deployment to an existing Sitemap, you'll need to map the domain(s) you'll be using to the Sitemap which can be done under Settings > Sitemaps within Agility. 

Production and Preview Deployments

A Production Deployment will enable features that allow you to test URL Redirections and will simplify viewing various environments for Editors while a Preview Deployment will allow Editors to preview and verify content changes before publishing. 

How to Setup a Deployment

If your deployment has already been set up or you have multiple deployments, you can verify which deployment is set as your current Production and Preview deployments during the steps below. 

You will also be able to set your Production and Preview deployments to the domain(s) of your choice.  

If you’re using our Next.js starter and want to use Vercel we recommend reading  

  • Using our Next.js Starter

1. First, on the left-hand navigation, you'll want to click on Settings > Sitemaps. Then click on Setup Deployment.

2. Select the Deployment Provider you’d like to use. If using a Custom Deployment, you'll have to configure your deployment details

  • Name - The name for this deployment. (ex: Production) 
  • URL - The URL for this deployment. (ex: http://{your-website}.com) 
  • Preview Deployment - Check this to use as your Preview Deployment. 
  • Production Deployment - Check this to use as your Production Deployment. 

You're all set!

Further Reading

  • Using the Next.js Starter

In Agility, Sitemaps allow editors to manage multiple content destinations within a single Instance. A content destination can be considered a website, application, IoT, digital signage, etc. where editors can manage the pages and module components that make up the front-end of their digital solution.

An instance in Agility can have either a single Sitemap or multiple. In most cases, a Sitemap represents a Website. Sometimes called a "Page Tree", the Sitemap is a blueprint of your website's architecture.

In Agility, your Sitemaps are conveniently located within the Pages section of the Content Manager app. At a glance, you can see your Sitemap(s), which pages are within each Sitemap, and you can tell where each page is and how it relates to other pages around it. This shows the hierarchy of the pages as they will appear on the front-end of your digital solution.

Front-end hierarchy in Agility CMS Select an Image

Each Sitemap can be composed with completely different pages, but utilize the same underlying architecture such as Page Templates, Page Modules & Content.

Sitemap Configuration

In Agility, Sitemaps often get associated with Deployments, and each sitemap usually has one or more deployment.

For example, a Sitemap called Website might have the following deployments associated with it:

Production: https://www.mywebsite.com

Preview: https://www.preview.mywebsite.com

When setting up a Sitemap for the first time, or adding a deployment to an existing Sitemap, you'll need to map the domain(s) you'll be using to the Sitemap which can be done under Settings > Sitemaps within the Content Manager.

Sitemap configuration in Agility CMS Select an Image

Production and Preview Deployments

When you specify a Production Deployment, this enables features that allow you to test URL redirections and simplifies viewing various environments for editors.

When you specify a Preview Deployment, this allows editors to preview and verify content prior to publishing.

How to Set up a Deployment

If your deployment has already been set up or if you have multiple deployments, you can verify which deployment is set as your current Production deployment and which deployment is set as your current Preview deployment.

You will also be able to set your Production and Preview deployments to the domain(s) of your choice. 

First, on the left-hand navigation, you'll want to click on Settings > Sitemaps. Then click on Setup Deployment.

Setting up a deployment in Agility CMS Select an Image

Next, select your Deployment Provider.

Selecting an deployment provider for Agility CMS Select an Image

If setting up a Custom Deployment, you'll be able to configure your deployment details.

Entering deployment details in Agility CMS Select an Image

Name: The name for this deployment. (ex: Production)

URL: The URL for this deployment. (ex: http://{your-website}.com)

Production Deployment: Check this to use as your Production Deployment.

Preview Deployment: Check this to use as your Preview Deployment.

Previewing deployment in Agility CMS Select an Image

← Previous
Getting Started with Linked Content
Next →
Page Models
On this page
What are Sitemaps and why are they important?Accessing SitemapsSitemap ConfigurationProduction and Preview DeploymentsHow to Setup a Deployment
Agility CMS documentationAgility CMS documentation

Documentation for the CMS built for editors, developers, and AI agents.

Docs
  • Overview
  • Editors
  • Developers
  • Owners & Admins
  • Training Guide
  • Changelog
Resources
  • Get Support
  • MCP Server
  • System Status
  • llms.txt
Agility
  • agilitycms.com
  • Start Free Trial
  • Sign in
  • Blog
© 2026 Agility Inc. All rights reserved.
Privacy PolicyTerms of Service