Hero Section Shortcode
movie_engine_hero shortcode featured banner: Use [movie_engine_hero] in MovieEngine for a featured hero banner for movies, series, or custom content, with slider, autoplay, layout, overlay, and content visibility controls.
Basic Usage
[movie_engine_hero]Example
[movie_engine_hero post_type="movie_engine_movie" type="trending" limit="5" autoplay="true"]Core Query
Controls which content is displayed in the hero section.
| Parameter | Type | Default | Description |
|---|---|---|---|
post_type | string | — | Content type (movie_engine_movie, movie_engine_series, etc.) |
limit | number | 5 | Number of items to display |
ids | string | — | Comma-separated post IDs |
type | string | — | Predefined query (trending, new_releases, upcoming, top_rated) |
orderby | string | date | Sorting method |
order | string | DESC | Sort direction |
Example
[movie_engine_hero post_type="movie_engine_movie" limit="5" orderby="date"]Taxonomy Filters
Filter hero content using taxonomy values like genre, year, or language.
| Parameter | Type | Default | Description |
|---|---|---|---|
genre | string | — | Genre slug |
year | string | — | Year slug |
language | string | — | Language slug |
Example
[movie_engine_hero genre="action" year="2024"]Layout & Display
Control hero layout style and structure.
| Parameter | Type | Default | Description |
|---|---|---|---|
layout | string | slider | Layout type (slider, single) |
style | string | default | Hero style variation (style1, style2, style3) |
height | string | auto | Hero section height (px, vh) |
overlay | string | true | Enable overlay background |
overlay_opacity | number | 70 | Overlay darkness (0–100) |
Example
[movie_engine_hero layout="slider" overlay="true" overlay_opacity="80"]Slider Options
Only applies when layout="slider".
| Parameter | Type | Default | Description |
|---|---|---|---|
autoplay | string | false | Enable autoplay |
autoplay_speed | number | 3000 | Delay between slides |
loop | string | true | Infinite loop |
pause_on_hover | string | true | Pause on hover |
show_dots | string | true | Show navigation dots |
Example (Slider)
[movie_engine_hero autoplay="true" autoplay_speed="5000" loop="true"]Content Visibility
Control what appears inside each hero item.
| Parameter | Type | Default | Description |
|---|---|---|---|
show_title | string | true | Show title |
show_meta | string | true | Show metadata (year, duration) |
show_description | string | true | Show description |
show_buttons | string | true | Show action buttons |
show_rating | string | true | Show rating |
show_views | string | false | Show views |
Example
[movie_engine_hero show_description="false" show_views="true"]Action Buttons
Control hero CTA buttons.
| Parameter | Type | Default | Description |
|---|---|---|---|
show_watch_now | string | true | Show Watch Now button |
show_watch_later | string | true | Show Watch Later |
show_trailer | string | true | Show Trailer button |
show_add_to_list | string | true | Playlist button |
Example (Buttons)
[movie_engine_hero show_watch_now="true" show_trailer="false"]Styling
| Parameter | Type | Default | Description |
|---|---|---|---|
custom_class | string | — | Custom CSS class |
Supported Values
post_type
- movie_engine_movie
- movie_engine_series
- movie_engine_season
- movie_engine_episode
type
- trending
- new_releases
- upcoming
- top_rated
layout
- slider
- single
Related Shortcodes
movie_engine_librarymovie_engine_grid
Behavior Notes
- If
idsis set → overrides all queries - If
typeis used → overridesorderby - The slider is disabled when there is only 1 item
- Uses featured image/backdrop as background
Example Shortcodes
Trending Hero
[movie_engine_hero type="trending" limit="5"]Single Featured Movie
[movie_engine_hero ids="123"]Hero Slider with Autoplay
[movie_engine_hero layout="slider" autoplay="true" autoplay_speed="4000"]movie_engine_hero shortcode featured banner explained
movie_engine_hero shortcode featured banner controls what appears in a featured hero section: the content query, the slider or single layout, the overlay and height, and which titles, metadata, descriptions, and action buttons are shown.
Use the slider options for autoplay, speed, looping, and navigation dots, and the content visibility parameters to show or hide the title, metadata, description, rating, views, and buttons such as Watch Now, Watch Later, Trailer, and Add to List.
Frequently asked questions
What is [movie_engine_hero]?
[movie_engine_hero] displays a featured hero or banner section for movies, series, or custom content.
Can the hero shortcode autoplay?
Yes. It offers slider and autoplay options, plus layout, overlay, and content visibility controls.
What action buttons can a hero show?
A hero can show action buttons configured through the shortcode parameters in this guide.
Related guides
Tip: for more about MovieEngine, visit the MovieEngine website.
