A Carousel shows a row of images that scroll sideways. You choose how many images are visible at once (the columns); when there are more images than columns, arrows — and, optionally, autoplay — move to the next group. With a single column it behaves like a simple image slideshow.

What it is for

Use a Carousel to show a set of images in a compact strip: event photos, product shots, partner logos with links, or a rotating set of banners in a narrow column. Each image can link to a page and can show a caption under it.

See it live on the example page APB Carousel, which also shows a one-column carousel inserted in a Simple Content region.

Structure

• The Carousel component holds the layout (columns, gap, image size), the behaviour (autoplay, navigation, loop) and the list of slides.
• Slides (APB Carousel slide) — one per image, with an optional link and caption.

Component settings

Setting	Options	Default	What it does
Section Title / Show Section Title / Intro	—	— / No / empty	See Section Title and Intro Text.
Target Placement	Body, Main Content Top/Bottom, Top region, Sidebars, Internal Placement 1–3	Body	See Target Placement.
Columns	1 … 10	4	How many images are visible at the same time. With 1 the carousel becomes a slideshow of single images and Column Gap is ignored. See Columns and Column Gap.
Column Gap	0 … 60px	10px	Space between visible images.
Slide image size	Small, Medium, Large, XL, 2XL	Medium	Which resized copy of each image is loaded. Pick the smallest size that still looks sharp at the number of columns you use: Small for 4 or more columns, Large/XL for 1–2 columns.
Autoplay	Yes / No	Yes	Advances automatically every few seconds. Pauses while the pointer is over the carousel.
Navigation	Yes / No	Yes	Shows the previous/next arrows.
Infinite loop	Yes / No	No	After the last image, continue with the first instead of stopping.
Show slide titles	Yes / No	No	Displays each slide’s Title as a caption under the image.
Color Style	Black, White, Teal Blue, Blue, Orange, Green, Red, Silver and Blue	Black	Color of the arrows and captions. See Color Style.
Component Width	25% … 100%	100%	See Component Width.
Custom Class	text	empty	See Advanced settings.
Container Settings	—	32px bottom margin	See Container Settings.

Slide fields

Field	Required	What it does
Image	yes	PNG, GIF, JPG or WebP. Use images with the same proportions for every slide so the strip stays even.
Title	no	Caption under the image, shown only when Show slide titles is Yes.
Link	no	Internal or external URL; the whole image becomes a link.
Internal description	no	Editor note for the Add existing search; not shown on the site.
Custom slide class	no	Extra CSS class on this slide.

How to use it

1. Click Add Carousel in the Page Builder and give it a Section Title.
2. Set Columns to the number of images you want visible at once, then choose a matching Slide image size.
3. Decide on Autoplay, Navigation and Infinite loop. For a short set of images that must all be seen, keep Navigation on.
4. Click Add new Slide, upload the image, add a Link and a Title if needed, and click Create. Repeat for each image.
5. Save and check the page. If images look blurry, choose a larger image size; if the strip is slow to load, choose a smaller one.

Tips

• Add at least one more slide than the number of columns, otherwise there is nothing to scroll and the arrows do nothing.
• For sponsor or partner logos that should scroll continuously, prefer Infinite Logos; for full-width banners with text, prefer Slideshow.
• A one-column carousel inside a Simple Content region is a good way to put a small slideshow next to a paragraph of text.

For site builders

Item	Value
Module	apb_pb_carousel
Paragraph types	apb_pb_carousel, apb_pi_carousel
Requires	apbuilder, Paragraphs, Entity Reference Revisions, Inline Entity Form, Field Group, Taxonomy Machine Name, core Image / Link / Options / Taxonomy / Text
Own vocabulary	apb_tax_carousel_image_size (Small … 2XL); image styles apb_carousel_small … apb_carousel_2xl
Shared vocabularies	apb_tax_columns, apb_tax_column_gap, apb_tax_cs_01, apb_tax_width, apb_tax_target_placement
Front-end	Splide (from apbuilder/aero-page-builder-core) configured from data-apb-* attributes; arrow colors injected as inline CSS.
Container settings	Full profile.
Example page	/apbuilder_examples/apb-carousel