Creating an Atom Feed documentation for the dotCMS Content Management System

The Atom Syndication Format is an XML language used for web feeds. Here's an example of how to take a dotCMS content type and create a widget to display an Atom feed.

Follow the next steps using the "News" content type from dotCMS' starter site:

1. Select Site -> Browser from the navigation panel.
2. Right-click on a folder and select New -> Page.

3. In the Add/Edit HTML Page screen enter the following information and click on Save:

Note: You must use a Blank Template (a template that doesn't have any headers or HTML only one container) for a page that generates an Atom feed.

4. In Edit Mode, click on a Body Container: Add Content button and select “Add Widget”.

5. In the popup select the Simple Widget Content Type in the left column.
6. Click on the Create New Simple Widget button.

7. In the Add/Edit Simple Widget screen:
  • Enter the title (e.g. “News - Atom Feed”).
  • In the Code field enter the following code:
    <?xml version="1.0" encoding="utf-8"?>
    <feed xmlns="">
        <title>News Feed</title>
        <subtitle>Atom Feed Example.</subtitle>
        <link href="" rel="self" />
        <link href="" />
        #foreach($con in $dotcontent.pull("+contentType:News",10,"title asc"))
                <link href="${con.urlTitle}" />
  • Click the Save button.


  • The code above creates the feed by outputting the XML tags required for the feed and then doing a content pull of all News items in your dotCMS content store.
  • You can modify the content pull to query any other content you want to display on the feed.
Preview the Feed

To preview the feed, select the Preview tab. This feed can be used by other sites to ingest dotCMS content and be displayed in external websites. Click on Publish Page to make your feed live. The feed can be accessed using an RSS reader.


For more information about required and optional fields in your Atom feed, please see the Atom documentation.