Person / Cast Shortcode
Person cast shortcode: Display a list, grid, or slider of people (actors, directors, cast members) with optional filtering, layout control, and metadata. [movie_engine_person_list] displays people such as actors, directors, and cast members in a list, grid, or slider.
π Basic Usage
[movie_engine_person_list]
Example
[movie_engine_person_list limit="12" columns="5" layout="grid"]
Core Query
Controls which people (cast) are displayed.
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 12 | Number of persons to display |
ids | string | β | Comma-separated person IDs |
orderby | string | name | Sorting method (name, popularity, date) |
order | string | ASC | Sort direction (ASC, DESC) |
type | string | β | Predefined type (popular, trending) |
Example
[movie_engine_person_list limit="10" orderby="name" order="ASC"]
Filters
Filter people based on roles or categories.
| Parameter | Type | Default | Description |
|---|---|---|---|
role | string | β | Filter by role (actor, director, writer) |
gender | string | β | Filter by gender |
known_for | string | β | Filter by known category (movie, series) |
πΉ Example (Filters)
[movie_engine_person_list role="actor"]
Layout & Display
Control how the person list is displayed.
| Parameter | Type | Default | Description |
|---|---|---|---|
layout | string | grid | Layout type (grid, slider, list) |
columns | number | 4 | Desktop columns |
columns_laptop | number | 4 | Laptop columns |
columns_tablet | number | 3 | Tablet columns |
columns_mobile | number | 2 | Mobile columns |
gap | string | β | Space between items (px) |
style | string | default | Card style |
πΉ Example (Layout)
[movie_engine_person_list layout="grid" columns="5"]
Slider Options
Only applies when layout="slider".
| Parameter | Type | Default | Description |
|---|---|---|---|
autoplay | string | false | Enable autoplay |
autoplay_speed | number | 3000 | Slide delay |
loop | string | false | Infinite loop |
pause_on_hover | string | true | Pause on hover |
show_dots | string | false | Show dots navigation |
πΉ Example (Slider)
[movie_engine_person_list layout="slider" autoplay="true"]
Card Content
Control what information appears on each person’s card.
| Parameter | Type | Default | Description |
|---|---|---|---|
show_name | string | true | Show person name |
show_character | string | true | Show character name |
show_department | string | false | Show department (Acting, Directing) |
show_known_for | string | false | Show known for |
show_profile_image | string | true | Show profile image |
πΉ Example (Card)
[movie_engine_person_list show_character="true" show_known_for="true"]
Section Header
| Parameter | Type | Default | Description |
|---|---|---|---|
title | string | β | Section title |
show_view_all | string | false | Show βView Allβ button |
view_all_url | string | β | Custom URL |
Styling
| Parameter | Type | Default | Description |
|---|---|---|---|
custom_class | string | β | Custom CSS class |
Supported Values
layout
- grid
- slider
- list
orderby
- name
- date
- popularity
role
- actor
- director
- writer
π Related Shortcodes
movie_engine_librarymovie_engine_hero
Behavior Notes
- If
idsis set β overrides all filters - Slider disables automatically if only 1 item
- Uses TMDb or custom person data
- Automatically links to person detail page
Example Shortcodes
Popular Actors
[movie_engine_person_list role="actor" type="popular" limit="12"]
Directors Slider
[movie_engine_person_list role="director" layout="slider" autoplay="true"]
Specific Cast Members
[movie_engine_person_list ids=”12,45,78″]
movie_engine_person_list shortcode cast actors explained
The shortcode controls which people are displayed through its core query parameters. Set limit to choose how many persons to display, use ids for a comma-separated list of person IDs, and sort with orderby (name, popularity, or date) and order (ASC or DESC). The type parameter also offers predefined types such as popular and trending, so a single shortcode can show popular actors or a directors slider without a separate page.
Filtering and layout work together. Filter by role (actor, director, or writer), gender, or known_for category (movie or series), then choose a layout of grid, slider, or list, with columns for desktop, laptop, tablet, and mobile, plus gap and style. Slider options cover autoplay, autoplay_speed, loop, pause_on_hover, and show_dots, and card content can show the name, character, department, known_for, and profile image. A section header with a title and an optional View All link, plus a custom_class for styling, rounds out the display. Remember the behavior notes: if ids is set it overrides all filters, a slider disables automatically if only one item is shown, the shortcode uses TMDb or custom person data, and it automatically links to the person detail page.
Frequently asked questions
What is [movie_engine_person_list]?
[movie_engine_person_list] displays people such as actors, directors, and cast members in a list, grid, or slider.
Can I filter people by role?
Yes. You can filter by role, gender, and known-for credits, with layout and slider control.
What card details can people show?
Person cards can show metadata options configured through the shortcode parameters.
Related guides
Tip: For the full shortcode list and more display options, see the MovieEngine website.
movie_engine_person_list shortcode cast actors: Use the examples on this page as a starting point β a popular actors list, a directors slider, or a specific cast selection β then adjust limit, columns, and card options to fit the page.
This approach keeps the movie_engine_person_list shortcode cast actors setup consistent across list, grid, and slider layouts, so visitors always see the same person cards in the same style.
