Portfolio carousel
Showcase project screenshots, design details, before-and-after visuals, or selected case study images in a compact carousel.
Shortcodes Ultimate Feature
WordPress Image Carousel Shortcode
The WordPress Image Carousel shortcode creates responsive image sliders and carousels with a simple shortcode. Select images from the media library, show featured images from posts, add lightbox links, captions, autoplay, arrows, dots and more without writing code.
- 50+ ready-to-use shortcodes
- Visual shortcode generator
- Works in posts, pages, widgets, and templates
- Slider and carousel layouts in one shortcode
Create image sliders and carousels without coding
Use Image Carousel when you need a clean visual section for portfolios, product shots, travel galleries, featured posts, client logos, or any image-heavy content.
Add it to a post, page, widget, or template and adjust the output with shortcode attributes or the visual shortcode generator.
- No separate heavy slider plugin for simple visual galleries
- No custom HTML, CSS, or JavaScript required
- Configure layout, links, crop, captions, autoplay, arrows, and dots with shortcode attributes
- Use images from the Media Library, featured images from posts, or taxonomy-based sources
What you can build with Image Carousel
Image Carousel is not only a gallery. Use it as a reusable visual content block anywhere a focused slider or compact carousel helps the page.
Product or service gallery
Display multiple product angles, service examples, or package visuals without turning the page into a long image stack.
Featured post carousel
Pull featured images from recent posts, selected posts, or category-based sources and link each slide to the original post.
Lightbox image gallery
Let visitors browse thumbnails inside the carousel and open full-size images in a lightbox when they want a closer look.
Logo or partner carousel
Use multiple columns, square crop, and spacing to present logos, partners, clients, sponsors, or press mentions.
Travel, event, or case study slider
Tell a visual story with captions, arrows, dots, and a one-column slider layout that keeps attention on one image at a time.
Everything you need in one image carousel shortcode
The [su_image_carousel] shortcode covers the common setup details for a responsive WordPress image carousel: sources, layout, crop, navigation, links, captions, autoplay, and image quality.
Flexible image sources
Choose Media Library images, selected posts, recent posts, or taxonomy-based sources.
Slider or carousel layout
Set columns from 1 to 8, from a classic slider to a multi-column carousel.
Mobile-friendly output
Use adaptive behavior to show a single column on mobile devices.
Crop and aspect ratios
Use landscape, square, portrait, or no-crop layouts such as 16:9, 4:3, or 1:1.
Captions and slide styles
Show captions and choose default, minimal, or photo slide styles.
Navigation controls
Enable arrows, dots, and dark or light control styles.
Links and lightbox
Link slides to full images, a lightbox, custom URLs, attachment pages, or post permalinks.
Autoplay and speed
Control autoplay intervals and transition speed, or disable autoplay when visitors need full control.
Image quality control
Select the WordPress image size used for slide image quality.
Developer-friendly filtering
Advanced users can adjust the gallery query with the su/get_gallery_slides_query filter.
Build image sliders and carousels with Shortcodes Ultimate
Install the free plugin and add responsive visual galleries to posts, pages, widgets, and templates.
WordPress image carousel shortcode examples
These examples use real [su_image_carousel] syntax. Replace sample media IDs, post IDs, categories, and taxonomy terms with values from your own WordPress site. For full syntax details, read the Image Carousel documentation.
Simple image slider
Use a one-column layout when you want a classic image slider for a hero section, gallery intro, or visual story.
[su_image_carousel source="media: 34494,34495,34496" columns="1" crop="16:9" arrows="yes" dots="yes"]Multi-column image carousel
Show several images at once on desktop and switch to a single-column layout on mobile.
[su_image_carousel source="media: 34494,34495,34496,34497" columns="3" adaptive="yes" crop="1:1" spacing="yes"]Lightbox gallery
Let visitors browse thumbnails and open full-size images in a lightbox.
[su_image_carousel source="media: 34494,34495,34496" link="lightbox" crop="4:3" captions="yes"]Recent posts carousel
Use featured images from recent posts and link each slide to the original post.
[su_image_carousel source="posts: recent" limit="6" link="post" captions="yes" crop="16:9"]Category or taxonomy carousel
Build a visual carousel from posts in selected categories or taxonomy terms.
[su_image_carousel source="taxonomy: category/3,5" limit="8" link="post" columns="2" adaptive="yes"]Custom linked carousel
Use custom slide links from the media editor when every image should point to a different destination.
[su_image_carousel source="media: 34494,34495,34496" link="custom" target="blank" columns="3" crop="1:1"]How to add an image carousel to WordPress
Start from the WordPress.org plugin listing or the Shortcodes Ultimate download page, then follow the shortcode generator workflow. You can also read the Shortcodes Ultimate setup guide.
-
1
Install and activate Shortcodes Ultimate
Start from the free WordPress.org plugin listing or the Shortcodes Ultimate download page, then activate the plugin on your site.
-
2
Open the content area
Edit a post, page, widget area, or template where WordPress shortcodes are supported.
-
3
Choose Image Carousel
Use the Insert Shortcode workflow and select Image Carousel, or type the shortcode manually if you prefer.
-
4
Select the image source
Pick Media Library images, selected posts, recent posts, or a taxonomy source depending on the page goal.
-
5
Adjust layout and behavior
Set columns, crop, links, captions, arrows, dots, autoplay, speed, and mobile behavior before publishing.
Choose the right carousel setup
Start with the page goal, then pick the layout and link behavior that matches how visitors should use the visual content.
| Goal | Recommended settings | Why |
|---|---|---|
| Classic image slider | columns="1", crop="16:9", dots="yes" |
Focuses attention on one image at a time. |
| Portfolio grid carousel | columns="3", adaptive="yes", crop="1:1" |
Shows multiple projects while staying mobile-friendly. |
| Lightbox gallery | link="lightbox", captions="yes" |
Lets visitors inspect full-size images. |
| Recent posts carousel | source="posts: recent", link="post" |
Turns featured images into a visual content feed. |
| Category showcase | source="taxonomy: category/3,5" |
Highlights specific topics or collections. |
| Accessible manual carousel | autoplay="0", arrows="yes", dots="yes", outline="yes" |
Gives users control and preserves keyboard focus. |
Best practices for WordPress image carousels
Image Carousel gives you the shortcode controls, but the content still matters. Choose image sizes, crop ratios, slide count, link behavior, and autoplay settings that match the purpose of the page.
For image galleries, lightbox links often work well. For content feeds, post links usually give visitors the next step.
- Use consistent image sizes and aspect ratios before uploading.
- Choose a crop ratio that fits the content: 16:9 for landscape photos, 1:1 for logos or cards, and portrait ratios for vertical images.
- Use image_size="large" or another appropriate size for the layout; avoid full-size originals unless the page needs them.
- Keep the number of slides reasonable and use limit for dynamic sources.
- Use link="lightbox" for galleries and link="post" for post-based carousels.
- Keep captions short and useful.
- Avoid overly fast autoplay; consider autoplay="0" when user control is more important.
- Keep the focus outline enabled to improve keyboard navigation.
- Test mobile layout, especially when using multiple columns.
Image Carousel shortcode FAQ
Can I use Image Carousel in the WordPress Block Editor?
Yes. Shortcodes Ultimate works with the Block Editor. You can insert the generated shortcode into Shortcode, Paragraph, or Classic blocks depending on your workflow.
Does Image Carousel work in the Classic Editor?
Yes. You can insert and edit the shortcode in the Classic Editor, including through the Insert Shortcode button if it is available in your setup.
Can I use Image Carousel in widgets or templates?
Yes, where WordPress shortcodes are processed. Developers can also use WordPress shortcode functions in templates when appropriate.
Can Image Carousel open images in a lightbox?
Yes. Set link="lightbox" to open carousel images in a lightbox.
Can I show featured images from posts?
Yes. Use sources like posts: recent, selected post IDs, or taxonomy-based sources, then use link="post" if each slide should link to the post.
Can I add custom links to slides?
Yes. Use link="custom" and add custom links in the media editor according to the Image Carousel documentation.
Is Image Carousel responsive?
Yes. Use adaptive="yes" to show a single column on mobile devices even when multiple columns are used on desktop.
Can I disable autoplay?
Yes. Set autoplay="0" to disable automatic slide transitions.
Can I change image crop and aspect ratio?
Yes. Use the crop attribute to choose landscape, square, portrait, or no-crop layouts.
What should I do if the carousel does not work?
Check for JavaScript errors and plugin or theme conflicts, then consult the Shortcodes Ultimate documentation and support resources.
Add a responsive image carousel to WordPress today
Install Shortcodes Ultimate and create image sliders, carousels, lightbox galleries, and visual post showcases with one shortcode.