Reference
RSS NewsSync — Complete Shortcode Documentation
Every shortcode attribute, every layout, and ready-to-copy examples for building any news section on your site.
1. Basic shortcode
[newssync]
Uses your default settings from the admin panel — no attributes required.
2. Main parameters (work in all layouts)
| Parameter | Example | Description |
|---|---|---|
layout | grid, list, carousel, hero, minimal | Choose the visual style |
limit | limit="6" | Maximum number of items (Hero/Carousel limited to 6) |
category | category="CNBC" | Show only one source (must match the category name you set on the feed) |
source | source="posts" | Use imported posts instead of live RSS |
autoplay | autoplay="on" | Enable/disable carousel autoplay (on/off) |
cache_ttl | cache_ttl="3600" | Cache duration in seconds (overrides the global setting) |
orderby | orderby="date" | Order by date or title |
order | order="DESC" | Sort order: DESC (newest first) or ASC (oldest first) |
offset | offset="3" | Skip the first N items PRO — limited by per-feed restrictions in the free version, see Unlimited Mode |
show_image | show_image="no" | Show/hide images. Works in all layouts: grid, list, carousel, hero. |
hide_image | hide_image="yes" | Alternative way to hide images — same as show_image="no" |
custom_css_class | custom_css_class="my-dark" | Adds a custom CSS class to the container — target the feed with your own CSS (e.g. for dark themes) |
3. List Mode (only when layout=”list”)
list_mode="standard"→ Classic list with imagelist_mode="minimal"→ Ultra-compact (title + time + source)list_mode="custom"→ Full control — see section 4
4. Custom Mode — full control
Use list_mode="custom" and combine any of these parameters. Note: show_image and hide_image also work in grid, carousel and hero layouts.
[newssync layout="list" list_mode="custom" limit="8" category="CNN" show_image="no" show_excerpt="yes" excerpt_length="20" show_date="yes" show_source="yes" date_format="H:i - d/m" show_readmore="yes" compact="yes"]
All available parameters
| Parameter | Description |
|---|---|
show_title="yes/no" | Show/hide title |
show_image="yes/no" | Show/hide image. Works in all layouts. |
hide_image="yes/no" | Alternative way to hide images — same as show_image="no". Works in all layouts. |
show_excerpt="yes/no" | Show/hide description |
show_date="yes/no" | Show/hide date/time |
show_source="yes/no" | Show/hide source name (CNBC, etc.) |
show_readmore="yes/no" | Show “Read more” link |
compact="yes" | Ultra-compact layout (perfect for narrow 30% columns) |
date_format="H:i - d/m" | Any PHP date format — see available formats |
excerpt_length="20" | Maximum number of words in the excerpt (max 25) |
5. Complete examples
Example 1: Grid with 6 items
[newssync layout="grid" limit="6"]
Example 2: Carousel with autoplay
[newssync layout="carousel" autoplay="on" limit="6"]
Example 3: List with a specific source
[newssync layout="list" category="BBC News" limit="10"]
Example 4: Ultra-compact sidebar
[newssync layout="minimal" limit="5"]
Example 5: Custom list without images
[newssync layout="list" list_mode="custom" show_image="no" show_date="yes" show_source="yes" compact="yes"]
Tip: show_image=”no” also works with layout=”grid” and layout=”carousel”.
Example 6: Hero banner
[newssync layout="hero" limit="3"]
Example 7: Using imported posts
[newssync source="posts" limit="8" layout="grid"]
Requires “Save RSS Items as Posts” enabled in Settings.
6. Layout comparison
| Layout | Best for | Characteristics |
|---|---|---|
| Grid | Main content areas, magazine style | Responsive columns, images, excerpts |
| List | Archives, news feeds, blog lists | Vertical list, customizable fields |
| Carousel | Featured content, homepage highlights | Sliding items, autoplay, navigation |
| Hero | Top banner, breaking news | Large images, prominent headlines |
| Minimal | Sidebars, widgets, compact spaces | Title + date + source only, no images |
💡 Pro tip — combining parameters: you can combine multiple parameters to create exactly the layout you need. Start with a basic layout, then add customizations one by one until you get the perfect result.