> For the complete documentation index, see [llms.txt](https://research-amp.gitbook.io/research-amp-user-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://research-amp.gitbook.io/research-amp-user-documentation/configuration/customization-and-layout/teaser-blocks.md).
# Teaser Blocks
For each content type (Articles, Research Topics, Profiles, etc), Research AMP provides a Teaser block (Article Teasers, Research Topic Teasers, Profile Teasers, etc). Teaser blocks offer a summary of items in a given type, so you can associate content with other sections of your site. They also are what populate the home page. When you begin to create content for the site, the teaser blocks on the home page automatically feature the new content.
For example, a scholar in your network may have written for your Research AMP site, hosted events associated with the topic, and written articles in your Zotero library. You may associate that content with this scholar's profile so that it shows up on their profile page. The teaser block will automatically populate when the profile is associated with other content on the site.
Many of the blocks you might want to use are already pre-populated into the templates. For example, if you’d like to quickly create a Research Review with the standard features, choose a template rather than adding in the individual features as blocks.
### Customizing Teaser Blocks
1. Open the Site Editor, and choose the Home Page template.
2. Click on the Block Inserter icon (the plus sign in the blue box in the top left corner of the window)
3. Choose the Research AMP block you would like to change. In the case of the image below, we have chosen the Research Review Teasers block. The list of options for displaying content is in the block editor panel on the right. See below for more information about these options.
### Content Display Options
Each Teaser block has a slightly different set of settings, depending on how the content type functions inside of a Research AMP site. Despite these differences, most Teaser blocks have one or more of the following settings panels. You can choose among these settings by clicking the block and choosing a different layout.
* Relevant: When set to “Relevant”, the block will show items that are relevant for the current page context. For example, a Research Review Teasers block set to “Relevant”, in the context of a single Research Topic page, will show Research Reviews that are associated with the given Research Topic.
* All: When set to “All”, the block will pull from all items of the given type, regardless of page context.
* Advanced: Use the “Advanced” setting when you want to show items associated with a particular Profile or Research Topic that you can specify.
### Layout
Most Teaser blocks support multiple layout options. Layout is controlled with buttons on the block toolbar, which is visible when the block is selected in the editor.
Layout options include:
* List: Items are presented in a vertical column.
* Grid: Items are presented in a grid, typically 3- or 4-columns wide on desktop, and adapting as appropriate on narrower screens.
* Featured: Available on the Article Teasers block, the Featured layout has a single ‘Featured Article’ slot in the left-hand column, and three stacked non-featured Articles in the right-hand column.
### Item Information Blocks
Research AMP includes a number of blocks that are compatible with multiple item types (Article, Research Review, etc), and dynamically display information about the current item. These are built in to the current Research AMP templates.
* Item Byline: Builds a byline for the current item, based on the Profiles that are associated with the item. You must create a profile for the author in order to assign an article to this person. This block has a toggle for including the item’s publication date.
* Item Research Topics: Displays links to Research Topics associated with the current item.
* Item Type Label: Used by default above the title of individual items, the Item Type Label indicates the type of item you’re currently viewing. In the case of Articles, this corresponds to the current Article Type (Video, Interview, etc). In the case of other item types, it’s simply the item type itself (Research Review, Citation, etc).
###
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://research-amp.gitbook.io/research-amp-user-documentation/configuration/customization-and-layout/teaser-blocks.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.