--- title: "News Slider Macro - Server/DC" canonical: "https://support.appfire.com/space/NEWS/306055157/News%20Slider%20Macro%20-%20Server%2FDC" format: markdown --- > Macro (aura-html) Use the News Slider macro to display news from blogposts and pages with thumbnails and excerpts in a simple and beautiful slider. ### Parameters ![image](media://fda5b4eb-7f31-465d-9cf5-33f4371fd9b8)   ### Parameters | **Parameter** | **Default** | **Description** | | --- | --- | --- | | *News selectors* | *Content Types*
`contentTypes` | blogposts | Choose whether you want to display news from pages or blog posts or both. Valid values are:
- *Pages *- Display news from pages. - *Blogposts* - Display news from blogposts. - *Pages and Blogposts* - Display news from pages and blog posts. | | *Labels*
`labels` | None | Comma-separated list of labels to search news by. Prefix labels with a **+** sign to indicate must-have labels or use a **-** sign to exclude news having a certain label. Examples:
- *confluence,jira* - Returns all news labelled with confluence OR jira. - *+confluence,+jira,-bitbucket* - Returns all news having labels confluence AND jira, excluding news labelled with bitbucket. | | *Spaces*
`spaces` | None - news from all spaces will be displayed | Comma-separated list of space keys to restrict searching of news. Use **@self** for current space. Leave blank for all spaces. | | *CQL Query*
`searchQuery` | None | Search query to further refine your news search. See [Confluence Search Syntax](https://confluence.atlassian.com/doc/confluence-search-syntax-158720.html) for more information. Examples:
- confluence OR jira returns all news containing either 'confluence' or 'jira' - "atlassian jira" returns all news containing the phrase 'Atlassian Jira | | *Time Frame*
`time` | 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:
- *m* - Minutes - *h* - Hours - *d *- Days - *w* - Weeks | | *Sort Order*
`sort` | creationDate | Choose the order the news should be sorted. Valid values are:
- *Title* - Sort by the title of the page or blog post. - *Title desc: *Sort by the title description of the page or blog post. - *First Created: *Sort by the first creation date of the page or blog post. - *Last Created: *Sort by the last creation date of the page or blog post. - *First Modified: *Sort by the first modification date of the page or blog post. - *Last Modified*: Sort by the last modification date of the page or blog post. - *modifiedDate* - Sort by the last modification date of the page or blog post. | | *Filter News By Date Range*
`datefilter` | Unchecked | This option allows you to sort the news by a specific date range. Enable this option, a calendar is displayed, then select the start and end date.
> ℹ️ Based on the sort order you have chosen, the sort is applied. | | *Reverse Order*
`reverseSort` | false | Enable for reverse sort order. | | *Max Results*
`maxResults` | 5 | The maximum number of news to be displayed in the slider. | | *Show Error If No News*
`showErrorIfNone` | true | Enable to show an error message when no news is found. | | *Slider Configuration* | *Width*
`width` | None - responsive width will be used | Width of the slider in pixels. Leave blank for responsive width. | | *Height*
`height` | None - the height of the tallest slide will be used | Height of the slider in pixels. Leave blank to automatically use the height of the tallest slide. | | *Auto Slide Display Time*
`delay` | 4sec | Slide through the slider to choose the duration (sec) you want to display each of the news entries. The duration ranges from 1 sec to 120 sec. | | *Buttons Color*
`color` | None - topbar color of the current space will be used | Color of prev/next navigation. Use hexadecimal notation or [HTML color name](https://www.w3schools.com/colors/colors_names.asp). Leave blank to automatically use the topbar color of the current space. | | *Background Color*
`backgroundColor` | #f5f5f5 | The background color of news entries. Use hexadecimal notation or [HTML color name](https://www.w3schools.com/colors/colors_names.asp). | | *Show Navigation*
`showNavigation` | true | Enable to show prev/next navigation. | | *Show Bullets*
`showBullets` | true | Enable to show navigation bullets. | | *News Cards Configuration* | *News Image Label*
`imageFilenameOrLabel` | None | The file name or label of the image you want to display as a news image in the slider. The image needs to be attached to the corresponding page or blog post. Leave blank to use the first image the slider can find attached to the page or blog post. If no image attachment with the given file name or label exists or the page or blog post has no image attachments at all, no news image will be displayed. Example: **thumbnail.png** | | *News Text*
`excerptType` | summary | Choose which part of the page or blog post content you want to display as news text:
- *Text Summary *- First 255 characters of text from page or blog post content. - *Full Text *- Entire text from page or blog post content. [NOTE] The Text option displays the data from the page from a basic page with only text. - *Excerpt Summary*- First 255 characters of text from inside *excerpt* macro. - *Full Excerpt *- Entire rendered content from inside *excerpt* macro. [NOTE] The Excerpt option displays the data from the *multiexcerpt* macro. - *Full Content* - Entire rendered page or blog post content. - *Content Summary*- First 255 characters of text from page or blog post content. [NOTE] The Content option displays the data from the page containing text as well as a *multiexcerpt* macro. | | *Display Space*
`showSpace` | false | Enable to display the name of the space in news entries. | | *Display Author*
`showAuthor` | false | Enable to display the author's name in news entries. | | *Display Publication Date*
`showDate` | false | Enable to display the publication date in news entries. | | *Display Creator*
`dispalycreator` | false | Enable this option to display the name of the creator in the news entries. | | *Display Created Date*
`dispalycreationdate` | false | Enable this option to display the creation date of the news or blog posts in the news entries. | | *Display Social Stats*
`showStats` | false | Enable to display the number of comments and likes in news entries. | | *Enable Links*
`enableLinks` | true | Enable to link news entries to their corresponding page or blog post. | | *Open Links in the new Window*
`openLinksInNewWindow` | false | Enable to open links in a new browser window, if links are enabled. | | Deprecated | *Auto Slide*
`autoSlide` | true | Enable to automatically slide through the news. | ### Creating News Silder macro To create a *News Silder *macro, perform the following steps: 1. Go to the page where you want to display the slides and click edit. 2. Click the **+** icon and search for the *News Silder* macro. (or) you can type* ****{ News***, the list with news macro suggestions is displayed. 3. Select *News Silder* macro. The *News Silder* macro is displayed. 4. 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. 5. You can customize parameters according to your requirements. For more information, see [Parameters](https://appfire.atlassian.net/wiki/spaces/NEWS/pages/306055157/News+Slider+Macro+-+Server+DC#Parameters). 6. Click **Apply**. 7. Publish the page.