How to Set up a Feed
You can set up feeds to power certain Themes blocks. This document walks you through how to do so.
Quick Guide
Click on a feed-driven block in PageBuilder. In the feature's Custom Fields, open the Content Configuration group and under Content Source, select ans-feed. In the next dropdown that appears, you'll see the options for the types of feeds you can create.
Select the type of feed you want to use, and configure it according to to the directions below.
Select the Number Of Stories you want to display, and the Offset, according to the directions below.
Selecting a feed
Feed of stories with a tag
Choose story-feed-tag from the content source dropdown. This content source lets you get a feed of stories that have a given tag on them.
You enter the tag's slug into the tagSlug field. The tag slug is simply the name of the tag, but 1) all lowercase 2) no special characters and 2) any spaces turned into dashes.
For example, the tag slug for Best Beaches is best-beaches:
 |
If you want a feed of stories with multiple tags, or with some tags but not others, you can use OR, AND and NOT operators. If you do so, the query must be contained within parentheses.
To get a feed with content that has either one tag or another:
(first-tag OR second-tag)
To get a feed with content that has both one tag and another:
(first-tag AND second-tag)
To get a feed with content that does not have a given tag:
(NOT first-tag)
You can add as many additional tags to these queries as you'd like:
(first-tag OR second-tag OR third-tag OR fourth-tag OR fifth-tag OR sixth-tag)
You can also combine the operators into one query:
(first-tag OR second-tag OR third-tag AND fourth-tag NOT fifth-tag NOT sixth-tag)
Feed of stories in a section
Chose story-feed-sections from the content source dropdown. This content source lets you get a feed of stories in a given combination of sections.
You'll enter Section IDs to create these feeds. The Section IDs come from Site Service; they're what you see on stories in Composer. For example, this story would be included in the /news/politics and /news sections:
 |
There are two fields you can use:
includeSections (required): Enter a comma-separated list of any section you want to include.
excludeSections (optional): If you want to exclude any sub-sections of a parent section, you can enter that Section ID here.
When you enter a Section ID, the feed will automatically return stories in that section and any of its child sections. For example, this feed will return any story in News and its child sections:
 |
If there is a child section of /news that you do not want to include in this feed, you can enter it in excludeSections. For example, perhaps you don't want stories in /news/local to appear in this feed:
 |
Feed of stories by an author
Choose story-feed-authors from the content source dropdown. This content source allows you to get a feed of stories by a given author.
You enter the author's slug into the authorSlug field:
 |
The author's slug is their name, but 1) all lowercase 2) no special characters and 2) any spaces turned into dashes. For example, Taylor Doe would be taylor-doe.
Similar to the tags feed, you can combine multiple author slugs with OR, AND and NOT operators if the query is enclosed in parenthesis. For example:
(author-one OR author-two OR author-three)
(author-one AND author-two)
(NOT author-one)
(author-one OR author-two AND author-three NOT author-four)
Advanced: Feed of stories from a query
Choose story-feed-query from the content source dropdown. This content source allows you to enter any query allowed by the Content API in the q parameter:
 |
See Content API Docs for details about what fields are queryable.
Selecting how many stories to display
You can decide how many stories to show in this feed by adjusting the feedSize field. This can be any number, up to 100.
For example, if you want 5 stories to display, enter 5. If you want 10 stories to display, enter 10.
Selecting the offset
The feedOffset field controls which story in the feed you want to start with.
All feeds are automatically sorted reverse-chronologically, meaning the most recent story is at the top of the feed. By entering 0 into the feedOffset field, your results will start 0 from the top. This is the most common use case.
If you want the feature you're setting up to actually display something besides the most recent story, then you can enter a different number here. For example, if you want this feature to display the 5th story from the top of the results, enter 5 here. This functionality is most frequently used if you have one feature at the top of the page that displays the most recent stories in that feed, and a separate feature downpage that displays additional stories in that feed.
One thing to keep in mind is that PageBuilder gets new content from each query separately, so stories can occasionally appear in two feeds at once.