---
title: "News Ticker Macro - Cloud"
canonical: "https://support.appfire.com/space/NEWS/305103891/News%20Ticker%20Macro%20-%20Cloud"
format: markdown
---
> Macro (aura-html)

Use the News Ticker macro to grab your latest breaking news from blogposts and pages and display them in a simple ticker.

### Parameters

| **Parameter** | **Default** | **Description** |
| --- | --- | --- |
| *News Selectors* | *Content Types*<br>`contentType` | Blog Posts | Choose whether you want to display news from pages, blog posts, or both. Valid values are:<br>- *Pages*** **- Display news from pages.
- *Blog Posts* - Display news from blogposts.
- *Pages And Blog Posts* - Display news from pages and blog posts. |
| *Labels*<br>`labels` |  | Comma-separated list of labels to search news by. |
| *Spaces*<br>`spacesSelected` |  | Select one or more spaces to restrict searching for news. Leave blank for all spaces. |
| *CQL Query*<br>`cql` |  | CQL Search query to further refine your search for news. Click [here to open the full CQL Documentation](https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/)<br>Examples:<br>- creator = "admin" returns news created by admin
- created = "2019/01/01" returns news created at 2019/01/01 |
| *Time Frame*<br>`timeFrame` |  | None - no time limit for news. Specify how far back in time Confluence should look for news to be displayed. Example: Use **12h** to display all news created or updated in the last 12 hours. Leave blank for no time limit. Available units are:<br>- *m* - Minutes
- *h* - Hours
- *d* - Days
- *w* - Weeks
- *M* - Months
- *y* - Years |
| *Sort Order*<br>`sortOrder` | Last Modified | Choose the order the news should be sorted by. Valid values are:<br>- *Title/Title Desc*- Sort by title of page or blogpost
- *First Created/ Last Created*- Sort by creation date of page or blogpost.
- *First Modified/ Last Modified*- Sort by last modification date of page or blogpost. |
| *Max Results*<br>`maxResults` | 5 | Maximum number of news to be displayed in the slider. |
| *Show Error If No News Found*<br>`showError` | Enabled | Enable to show error message when no news were found. |
| *Ticker Configuration* | *Title*<br>`title` | News | The title of the ticker to display. |
| *Width*<br>`width` | 100% | Width of the ticker in pixels or percents. |
| *Color*<br>`color` | #3873ae | Color of the ticker. Use hexadecimal notation or [HTML color name](https://www.w3schools.com/colors/colors_names.asp). |
| *Display Time*<br>`displayTime` | 4 seconds | How long each news entry will be displayed in seconds, 0 turns auto slide off. |
| *News Cards Configuration* | *News Text*<br>`newsText` | Title | Choose which part of the page or blogpost you want to display as news text:<br>- *title* - title of page or blogpost
- *excerpt* - content from inside excerpt macro |
| *Prefix Text*<br>`prefixText` |  | Optionally choose whether you want to display the space, author, creation date or last modification date before the news text. Valid values are:<br>- *Space*** **- Space of page or blogpost.
- *Author* - Author of page or blogpost.
- *Creation Date* - Creation date of page or blogpost.
- *Modified Date* - Last modification date of page or blogpost. |
| *Enable Links*<br>`link` | Enabled | Enable to link news entries to their corresponding page or blogpost. |
| *Open in Same Tab*<br>`sameTab` | Disabled | Enable to open the link in the current tab. |

### Creating News Ticker macro

To create a *News Ticker *macro, perform the following steps:

1. Create a new page or go to** Edit** the page where you want to create the news or blog post.
2. Type ‘/' or click the '+’ icon and search for the *News Ticker* macro.
3. Select *News Ticker* macro. The *Insert ‘News Ticker’ Macro *window is displayed.
4. Choose the *Content Type* from the drop-down.
5. Type the name of the space from where you pull the news and to help you the results are auto-populated. You can specify multiple space names.
6. You can customize parameters according to your requirements. For more information, see [Parameters](https://appfire.atlassian.net/wiki/spaces/NEWS/pages/305103891/News+Ticker+Macro+-+Cloud#Parameters).
7. Click **Insert**.