Skip to content
Content & Library

Person / Cast Shortcode

Estimated reading: 4 minutes 264 views

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.

ParameterTypeDefaultDescription
limitnumber12Number of persons to display
idsstringβ€”Comma-separated person IDs
orderbystringnameSorting method (name, popularity, date)
orderstringASCSort direction (ASC, DESC)
typestringβ€”Predefined type (popular, trending)

Example

[movie_engine_person_list limit="10" orderby="name" order="ASC"]

Filters

Filter people based on roles or categories.

ParameterTypeDefaultDescription
rolestringβ€”Filter by role (actor, director, writer)
genderstringβ€”Filter by gender
known_forstringβ€”Filter by known category (movie, series)

πŸ”Ή Example (Filters)

[movie_engine_person_list role="actor"]

Layout & Display

Control how the person list is displayed.

ParameterTypeDefaultDescription
layoutstringgridLayout type (grid, slider, list)
columnsnumber4Desktop columns
columns_laptopnumber4Laptop columns
columns_tabletnumber3Tablet columns
columns_mobilenumber2Mobile columns
gapstringβ€”Space between items (px)
stylestringdefaultCard style

πŸ”Ή Example (Layout)

[movie_engine_person_list layout="grid" columns="5"]

Slider Options

Only applies when layout="slider".

ParameterTypeDefaultDescription
autoplaystringfalseEnable autoplay
autoplay_speednumber3000Slide delay
loopstringfalseInfinite loop
pause_on_hoverstringtruePause on hover
show_dotsstringfalseShow dots navigation

πŸ”Ή Example (Slider)

[movie_engine_person_list layout="slider" autoplay="true"]

Card Content

Control what information appears on each person’s card.

ParameterTypeDefaultDescription
show_namestringtrueShow person name
show_characterstringtrueShow character name
show_departmentstringfalseShow department (Acting, Directing)
show_known_forstringfalseShow known for
show_profile_imagestringtrueShow profile image

πŸ”Ή Example (Card)

[movie_engine_person_list show_character="true" show_known_for="true"]

Section Header

ParameterTypeDefaultDescription
titlestringβ€”Section title
show_view_allstringfalseShow β€œView All” button
view_all_urlstringβ€”Custom URL

Styling

ParameterTypeDefaultDescription
custom_classstringβ€”Custom CSS class

Supported Values

layout

  • grid
  • slider
  • list

orderby

  • name
  • date
  • popularity

role

  • actor
  • director
  • writer

πŸ”— Related Shortcodes

  • movie_engine_library
  • movie_engine_hero

Behavior Notes

  • If ids is 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.

Share this Doc

Person / Cast Shortcode

Or copy link

CONTENTS
Back To Top