Post Carousel Module
Using the Post Carousel Module
Follow these steps to learn how to use the Post Carousel module.
Step 1: Add Post Carousel Module
Make your way to the page of your choice and add the Post Carousel Module.
Step 2: Customize The Post Carousel Module
After adding the Post Slider Module you will need to customize it by defining the Post Type and Custom Loop Layout. Please view the Post Carousel Module settings below.
Post Carousel Module Settings
Main Options
The Main Options section allows you to define which content is displayed in the carousel and what happens when no content is found.
-
Post Type
Choose the post type you want to display in the carousel (e.g.,Posts
,Pages
, or any custom post type such asPeople
). -
Custom Loop Layout
Select a layout from the Divi Library to display each post in the carousel. This layout can be built with a combination of the Divi and Divi Machine modules.noteFor more information on building a Custom Loop Layout, see the documentation here.
-
No Posts Layout
Optionally select a fallback layout from the Divi Library that will be displayed when no posts are returned by your carousel settings. -
No Posts Text
If no fallback layout is selected, this text will be shown instead. The default message is:
Sorry, No posts.
Loop Options
This is where you control which posts in your chosen Post Type are shown and how they are sorted. The settings are separated into 3 tabs which are detailed below.
General Tab
The General tab under Loop Options
allows you to control how many posts appear in the carousel and whether to include the current post.
-
Post Status
Choose the status of the posts to include in the carousel.
Common values includePublish
,Draft
, orPrivate
. -
Post Count
Set how many posts to display in the carousel.
This is useful if you want to limit the number of items shown (e.g., only 6 team members or 3 testimonials). -
Post Display Type
Choose how posts are sourced for the carousel. Depending on your selection, additional options will appear:-
Default
Shows posts based on the filtering and sorting settings configured in the other tabs. -
Related
Displays posts that are related to the current post based on shared taxonomy terms or ACF fields.
When selected, you’ll see aRelated Content
setting where you can choose one of the following methods for finding related content:Categories
Tags
Post Object
(based on an ACF Post Object field)ACF Field
(match posts using values from a specific ACF field)
noteIf you choose
Post Object
orACF Field
, ensure the field is correctly configured in theInclude Terms
tab using theFilter By ACF Name
option. -
Linked Post
Displays posts directly linked via an ACF Post Object field on the current post.
When selected, an additional field appears:Linked Post Object ACF Name
– Select the ACF field that holds the linked post(s).
tipUse this option when you want full control over which posts are displayed per post—for example, hand-picking team members for each project.
-
-
Include current post?
By default, the current post is excluded from the carousel (useful when placing the carousel on a single post page).
Toggle this ON to include the current post in the results.
Include Terms Tab
The Include Terms tab allows you to filter which posts appear in the carousel based on taxonomy terms or ACF field values.
-
Show Posts of current taxonomy terms on taxonomy page?
Enable this option to automatically show posts that match the taxonomy term of the current page (useful on category or tag archive pages).tipThis dynamic filtering only applies on taxonomy archive pages. Leave it disabled for static pages.
-
Include Categories
(comma-separated)
Enter the slugs of specific categories to filter by.
Example:news,events,case-studies
-
Include Tags
(comma-separated)
Enter the slugs of specific tags to filter by.
Example:divi,plugin,carousel
-
Choose Your Taxonomy
Select the taxonomy type used for filtering.
Options typically includecategory
,post_tag
, or any registered custom taxonomy. -
Include Custom Taxonomy
(comma-separated)
If you've selected a custom taxonomy above, list the slugs of the terms you'd like to include.
Example:featured,highlighted
-
Include ACF Field
Select an ACF field to use for filtering posts. This works best with text or select fields. -
Include ACF Value
Define the value from the ACF field to match. Only posts with a matching value will appear.noteThis ACF filtering is especially useful for advanced relationships, such as displaying posts that share the same department, location, or tag stored in a custom field.
Sorting Tab
The Sorting tab allows you to control the order in which posts appear in the carousel.
-
Sort Order
Choose the field to sort posts by. Options include:Date
: Sort by published date.Title
: Sort alphabetically by post title.ID
: Sort by post ID.Random
: Shuffle the order each time the page loads.Menu Order
: Use the order defined in the WordPresspage-attributes
or custom order plugins.Name
: Sort by post slug.Modified
: Sort by last modified date.ACF Field
: Sort using a custom ACF field (see below).ACF Date Picker
: Sort using an ACF Date Picker field with advanced filtering options.
-
Order
Define the direction in which posts are ordered:Ascending
: A–Z, 0–9, earliest to latest.Descending
: Z–A, 9–0, latest to earliest.
Sorting by ACF Field
If you select ACF Field
as the sort order, additional options will appear:
-
ACF Sort Field
Select the ACF field you want to sort by. This must be a field that contains numeric or text values. -
ACF Field Value Type
Choose the type of data in your ACF field:String
: For alphabetical text sorting.Numeric
: For sorting numerical values (e.g., price, rating, or weight).
Sorting by ACF Date Picker
If you select ACF Date Picker
, the following options will be shown:
-
ACF Date Picker
Select the ACF field that stores the date value. -
ACF Date Picker Method
Filter posts based on date logic:Default
: No date-based filtering; just sort by the ACF date.Today Only
: Only show posts where the date is today.Today and in the future
: Include dates from today forward.Today and next x days
: Show posts with dates within a defined range from today.In the Past
: Show posts where the date is in the past.Last 7 days (including today)
: Include posts dated within the last 7 days.Yesterday and past x days
: Show posts going back from yesterday for a set number of days.
noteThese advanced date filters are ideal for events, announcements, or any date-driven content.
Extra Options
These settings give you more control over the appearance and behavior of each post card inside the carousel.
-
Equal Height Grid Cards
When enabled, all post cards inside the carousel will have the same height—even if the content length varies.
Useful for maintaining clean alignment across slides, especially when using grid-style layouts. -
Link each layout to product
Enable this to make the entire custom loop layout clickable, linking to the single post or product page.noteThis setting is commonly used in shop-style layouts or team sections where each card should link through.
-
Align last module at the bottom
This aligns the last module inside each custom loop layout to the bottom, helping create consistent vertical alignment across post cards.
Especially helpful when your layouts include elements like buttons or meta info that should be bottom-aligned.
Carousel Settings
Use the Carousel Settings section to control the behavior and design of the slider on all screen sizes. You can choose between two supported libraries and fine-tune how the posts scroll and display.
Slider Library
Slider Library
Choose the JavaScript slider framework to power your carousel:Slick Slider
: A widely used, mature slider option.Swiper JS
: A modern and mobile-optimized slider with smoother animations and advanced features.
Navigation Controls
-
Swiper Prev CSS Class
/Swiper Next CSS Class
For Swiper JS, you can define custom class names for the previous/next arrow buttons if you’re styling them manually. -
Enable Arrows?
Toggle to show or hide left/right navigation arrows. -
Disable Arrow Shadow?
Removes the default shadow styling applied to navigation arrows. -
Enable Dot Navigation?
Show pagination dots below the carousel.
Responsive Layout Settings
Control how many posts appear and scroll at each breakpoint.
Desktop Posts in View
– Number of posts visible at once on desktop.Desktop Posts to Slide
– Number of posts that scroll when the carousel advances.Tablet Portrait Posts in View
Tablet Portrait Posts to Slide
Tablet Landscape Posts in View
Tablet Landscape Posts to Slide
Mobile Posts in View
Mobile Posts to Slide
For smooth layout behavior, we recommend setting the number of posts in view to odd values when using Center Mode.
Center Mode
Center Mode?
Enable this to highlight the middle post in the carousel and slightly shrink the surrounding items for visual focus.
This only works well with odd numbers in view (e.g., 3 or 5).
Center Mode only works when the Slick Slider library is selected.
Autoplay & Scrolling
-
Autoplay and Delay
Time (in milliseconds) between each auto slide. Leave blank to disable autoplay. -
Slide Speed
Duration (in milliseconds) of the slide animation. Default:300
. -
Infinite Scrolling?
Loop the carousel infinitely without stopping at the last post.
Animation Settings
CSS Ease
Choose the easing style for slide transitions. Options may include:ease
linear
ease-in
ease-out
ease-in-out