Soliloquy Carousel is an add-on for Soliloquy, enabling users to create stunning carousels on their websites. With this plugin, you can easily showcase your content, such as images and videos, in a visually appealing and interactive way. Whether you want to highlight your latest products, feature testimonials, or display portfolio items, this plugin provides a seamless and user-friendly solution.

Plugin Version: 2.2.3
 
WordPress plugin Soliloquy Carousel

Plugin Features

This plugin for WordPress allows users to create fully responsive and customizable carousels, ensuring that your content looks great on any device. With its intuitive interface and drag-and-drop functionality, the process of creating carousels becomes effortless. You can add, remove, and rearrange slides with just a few clicks, making it easy to update and maintain your carousels.

One of the standout features of Soliloquy Carousel is its wide range of customization options. You have complete control over the appearance and behavior of your carousels. You can choose from various navigation styles, including arrows, bullets, and thumbnails, to suit your websites design. Additionally, you can customize the transition effects and timings, offering a unique and engaging user experience.

Furthermore, this plugin offers advanced features for optimizing your carousels for performance and SEO. You can enable lazy loading, which ensures that images and videos are only loaded when they come into view, reducing page load times. This not only improves user experience but also benefits your websites search engine rankings.

Another notable feature of Soliloquy Carousel is its integration with Soliloquys dynamic add-ons. This allows you to dynamically populate your carousels with content from external sources, such as posts, pages, or custom post types. This dynamic functionality saves time and ensures that your carousels are always up to date with your latest content.

In conclusion, Soliloquy Carousel is an essential tool for anyone looking to create captivating carousels on their website. With its user-friendly interface, extensive customization options, and integration with Soliloquys dynamic add-ons, this plugin offers a seamless and efficient solution for showcasing your content in an engaging and interactive way.

Specifications:

Release date: 11-10-2016
Last updated: 20-05-2026
Type: Paid
License: GPL 
Subject: News Display
Compatibility: W5.x
Includes: Plugin
Language packs: English
Developer: -

Rating:
4.5296803652968 1 1 1 1 1 (219 Votes)

Download by subscription!

You need to log in on the site and purchase a club subscription!

Share with your friends!

 

Guide to Setting Up and Using Soliloquy Carousel

Soliloquy Carousel is not meant to simply add another moving block to a page. Its real purpose is different: it takes an existing Soliloquy slider and displays multiple items in a horizontal carousel, so visitors can see adjacent images, quickly browse the collection, and keep their sense of page context.

Soliloquy Carousel as an image carousel in WordPress
The core idea: configuring the carousel in the WordPress admin should produce a clear, predictable result on the page, not random image scrolling.

This guide covers addon installation, image prep, configuring the Carousel tab, mobile behavior, publishing through a block, shortcode, or widget, checking the final result, and troubleshooting common issues. It is written for site owners, editors, photographers, designers, and WordPress administrators who want a controlled carousel rather than guessing at settings through trial and error.

It is important to understand where this product fits. The Carousel Addon works as an extension for Soliloquy: first you create or edit a standard slider, then switch it into carousel mode and configure its own settings for item count, width, height, spacing, and how far it moves per animation step. So the real work is not about the plugin's generic description, but about the chain of "content -> carousel settings -> page output -> testing across screen sizes."

If you already know Soliloquy Lite, do not automatically carry all of those expectations over to Carousel Addon. In official sources, the carousel is part of the Pro ecosystem and is available through an addon. Before rollout, check your access level, confirm the core plugin is installed, make sure the required addon is active, verify the condition of the images in the media library, and confirm that your current theme outputs scripts correctly in the footer.

When a Carousel Works Better Than a Standard Slider

A standard slider usually shows one large slide and asks the visitor to wait or click an arrow to see the next item. A carousel solves a different problem: it shows several items at once and makes a collection easier to scan. That is especially useful when each item does not need to take over the entire above-the-fold area on its own.

Soliloquy Carousel works well for serial content: project photography, product cards, a mini event gallery, a video collection, visual proof points for a service, client logos, or a compact showcase of articles or illustrations. The user sees more than a single image - they see part of a collection. Because of that, the carousel works more like navigation through a set than like a standalone promo banner.

This approach also has a practical advantage on product and service pages. If you are showing a photographer's portfolio, design work, interior options, restaurant dishes, or a set of instructional visuals, visitors care about scan density. They do not want to wait for every transition. They should be able to tell immediately that the collection goes beyond a single frame and browse through it at their own pace.

But a carousel should not become a universal replacement for every kind of content. If you have one primary offer, one key image, or text that needs careful reading, a regular static block is often better. A carousel requires discipline: consistent proportions, short captions, a clear order, and load-speed checks. Without that, it turns into a noisy block that takes up space and hurts comprehension.

Scenarios Where Soliloquy Carousel Is Especially Useful

  • Portfolios and photo series. Visitors can quickly review several pieces of work and understand the creator's style without scrolling through a full-page gallery.
  • Catalog selections. Multiple products, case studies, or objects can be shown compactly, especially when each slide links to its own page.
  • Video and mixed content. The official addon page lists support for images, photos, videos, and galleries, but in these setups it is especially important to test behavior on mobile devices.
  • Blocks with repeatable visual proof. For example, photo testimonials, client logos, workflow stages, or a set of before-and-after results.

Choose between a slider and a carousel by asking one question: "Does the user need to see several adjacent items at once?" If the answer is yes, a carousel makes sense. If the entire idea depends on one strong image or a long piece of text, it is better not to complicate the interface.

What to Check Before Installing and Enabling the Addon

Good setup does not start with the Enable Slider Carousel? checkbox. It starts with checking the environment. Soliloquy Carousel has requirements: you need the core Soliloquy plugin, addon access at the right license tier, and a compatible WordPress installation. The official Carousel Addon documentation lists WordPress 4.8+ and Master, Agency, or Developer licenses for this addon. At the same time, WordPress itself recommends a modern hosting stack, so on a live site it is better to align with current platform requirements rather than the historical minimum on an older documentation page.

Make sure Soliloquy is installed and working with a basic test slider. If the base slider cannot be created, does not save images, or does not render on the page, enabling Carousel Addon will only make troubleshooting harder. First create a simple slider with two or three images, publish it on a draft page, and confirm that the front end is receiving the necessary scripts and styles.

Technical Checklist Before Enabling It

  • The Soliloquy section opens in the WordPress admin, and you can create a new slider.
  • Images upload to the media library and keep their captions and alt text.
  • The installed Carousel addon is visible under Soliloquy -> Addons and can be activated.
  • A regular Soliloquy slider renders on a test page without an endless loading indicator.
  • Your theme properly outputs footer scripts via wp_footer(), because without it many sliders and carousels never initialize on the public-facing site.
  • Cache, JavaScript optimization, and the image CDN are temporarily under control: you can clear cache or disable questionable optimization while testing.

Do not start on the homepage. Create a separate test page or private draft where you can change sizes, spacing, and item counts without risking the main screen of the site. This matters even more with a carousel: the same settings can look clean in a wide content column and feel cramped in a sidebar.

Rule of thumb: first get a standard slider rendering reliably, then enable carousel mode. If you skip that step, it becomes much harder to tell whether the issue is in Carousel Addon, core Soliloquy, the theme, caching, or the images themselves.

Installing Carousel Addon and Running the First Test

The official Soliloquy documentation recommends enabling addons through Soliloquy -> Addons. On the addons screen, the available items depend on your access level. If Carousel Addon does not appear as available, do not go looking for workaround ZIP files or copy files from untrusted sources. Check your license level, the state of the main installation, and whether the site is properly connected to Soliloquy updates.

The installation flow itself is simple: open the addons section, find Carousel Addon, install it, then click Activate. After that, the Carousel tab should appear when editing a slider. If the tab does not appear, first refresh the slider editing screen, then confirm that the addon is activated on this specific site and that there is no Lite version installed alongside it that is interfering with the working feature set.

Safe First-Run Order

  1. Open Soliloquy -> Addons and install Carousel Addon if it is available for your setup.
  2. Click Activate for the addon and wait for the status to change in the admin panel.
  3. Create a new test slider or open an existing one that already works correctly.
  4. Add 5-8 images with the same orientation. For the first test, do not mix portrait, landscape, and heavily panoramic images.
  5. Open the Carousel tab, enable Enable Slider Carousel?, and set the basic parameters.
  6. Save the slider with Publish or Update.
  7. Insert the slider on a test page and check the front end in a normal browser window and at mobile width.

At this stage, do not try to get a perfect design right away. The first test should answer four questions: does the carousel render, are the items free of odd duplication, does the scrolling work, and does the mobile version behave predictably? Only after that does it make sense to fine-tune width, height, spacing, and item count.

What Should Appear After Activation

When editing a slider, you should see the Carousel tab. The documentation for this screen mentions settings for the width and height of each image, the minimum and maximum number of slides to display, the spacing between them, and how many slides move per animation. These are not cosmetic settings. They determine whether the carousel looks like a clean strip or like a collection of elements that get cropped, pushed out of the container, or misaligned.

Also check the Mobile tab. The documentation notes that it includes an option to use the carousel on tablets and mobile devices. If you do not enable it, the mobile version may display as a standard Soliloquy slider instead. That is not an error - it is expected behavior. In some cases, it is even preferable if several small cards become too tiny on a phone.

How the Carousel Tab Settings Work Together

The best way to think about Carousel Addon settings is as a system. Width and height define the size of a single card, the minimum and maximum item counts control the density of the strip, spacing affects the breathing room between slides, and the movement setting controls the browsing pace. If you adjust these values one at a time and watch the result, the carousel becomes much easier to control.

Setting up Soliloquy Carousel in the Carousel tab
The key carousel settings work together: item size, visible slide range, spacing, and scroll step.

Item Width and Height

In Carousel Addon, item size affects more than visual scale - it also affects cropping. The documentation explicitly warns that each image's width and height are used with cropping. That means source photos with different proportions will be forced into a uniform look. For a neat carousel, that is convenient, but for images where the edges of the frame matter, it can be a problem.

Before configuring everything at scale, choose one visual standard. For example, a wide format may work well for portfolio cards, an almost square one for products, and a separate carousel with a different composition for vertical work. Do not mix long banners, portrait images, and square icons in one slider unless you are prepared to review the crop of every frame manually.

Minimum and Maximum Visible Slides

The minimum and maximum item count help the carousel adapt to the width of its container. A maximum that is too high may look good on a wide monitor but shrink the items into tiny tiles on a laptop. A maximum that is too low makes the carousel feel too much like a standard slider and removes the main benefit of the mode.

For a solid first version, choose moderate density. In a wide content column, 3-4 items is often enough. In a narrow sidebar, 1-2 is better. For logos, you can allow more items because each slide is visually simpler. For photos with details and captions, fewer items at a larger size usually work better.

Spacing Between Items

Spacing looks minor, but it is what separates a clean carousel from an overcrowded strip. If the items almost touch, it becomes harder for visitors to tell where one slide ends and the next begins. If the spacing is too large, the carousel loses density and starts to look fragmented.

Good spacing depends on the theme. In a minimalist theme, you can leave more air. On a dense commercial page, spacing is usually tighter so the block does not stretch too far. Check not only the appearance but also the clickable areas: if the slides are links, users should land on the correct item instead of accidentally clicking the neighboring one.

Slides Per Movement

The movement setting determines how dramatic the change feels after a click or swipe. Moving one item at a time makes browsing smoother and more predictable. Moving several at once lets the user flip through the collection faster, but it can also break the visual connection between the previous set and the next one. For portfolios and galleries, a one-item shift is usually easier to use. For logos or repetitive cards, a larger step can be fine.

How to Choose Settings for Different Types of Carousels
Scenario What Matters Most Practical Setup
Photographer portfolio Image quality and readable detail Fewer visible items, larger size, move one slide at a time.
Client logos Density and fast scanning More items per row, small spacing, no long captions.
Product selection Consistent cards and clear transitions Uniform height, metadata links, mobile click testing.
Video collection Stable loading and a clear poster image Do not overload the page; test initialization and playback behavior.

After every change, save the slider and reload the page. Some problems only show up on the public-facing site: a theme CSS conflict, delayed script loading, incorrect CDN cropping, or captions that are too small.

Images, Captions, Links, and SEO Inside the Carousel

A carousel is built from slides, and in Soliloquy a slide is more than just an image. In the official documentation for creating a first slider, the metadata editor includes the title, caption, alt text, and URL. That matters even more with Carousel Addon because multiple adjacent items compete for attention. If captions are too long, links are random, and alt text is empty, the carousel turns into visual noise and becomes less useful to the page.

Alt Text and Captions

Alt text is not there to hold a pile of keywords. It should explain the meaning of the image to people who cannot see it or access it through assistive technology. For a portfolio, that might be the subject and type of work; for a product, the name and a key characteristic; for an instructional slide, the outcome of an action. In your first slider, it is better to fill in alt text manually rather than rely on file names from the media library.

Captions in a carousel should be shorter than in a standard gallery. In a narrow item, a long sentence quickly breaks the composition. If the text really matters, move it next to the slider or onto the destination page the slide links to. Use the carousel itself as visual navigation.

Links on Slides

Soliloquy lets you add URLs to slides through the metadata editing window. For a carousel, that is useful: each item can link to a case study, product page, service page, article, or larger image. But those links need to be intentional. Do not assign the same URL to every item if the user expects to land on a specific object.

After saving metadata, always test the click behavior on the public page. If a link does not work on a phone, check whether another theme element is overlapping it, whether a conflicting lightbox is enabled, or whether a cache plugin is optimizing scripts so aggressively that event handlers start too late.

Image Dimensions and Page Stability

The Soliloquy documentation also describes the Set Dimensions on Images? option, which adds width and height to the img element. It also explains that this can help with Google PageSpeed requirements and CDN-related situations where images display incorrectly. In a carousel, that is especially noticeable: if the browser does not know the future size of the images, the page can jump during load.

Do not turn on every optimization blindly. If the page already performs well, there is no need to change everything at once. But if Lighthouse or Chrome DevTools shows layout shifts around the carousel, then setting image dimensions, using consistent source proportions, and checking the container CSS should be the first troubleshooting steps.

Displaying the Carousel on a Page, in a Block, and in a Widget

Once the slider is configured, the next step is choosing where to display it. Soliloquy supports insertion through a block, shortcode, and widget. The right choice depends less on editor trends and more on where your content actually lives. For a normal page in the block editor, the Soliloquy block is the easiest option. For a template location, a legacy editor, or technical documentation, shortcode is practical. For a sidebar or widget area, the widget works well if your theme still uses those zones.

Example of displaying Soliloquy Carousel through a block and shortcode
The display method should match the location: block for a page, shortcode for flexibility, widget for a theme area.

Soliloquy Block in the WordPress Editor

The official Gutenberg documentation shows the basic workflow: create a slider, publish it, open a page or post, add the Soliloquy block, and select the required slider from the dropdown list or by searching for its name. This is the easiest path for an editor who does not want to copy shortcode manually.

The block has one major advantage: the editor can see exactly which slider is being inserted. If you have a lot of carousels, do not name them "Slider 1." Use names based on placement and purpose instead: "Portfolio - Home Page," "Testimonials - Services," or "Catalog - New Collection." Visitors never see those names, but they save administrators from costly mistakes during page updates.

Shortcode as a Universal Insertion Method

When you edit a published slider, Soliloquy shows the available insertion methods, including shortcode. This is useful in the classic editor, some page builders, template fields, and any place where the block is not available. Shortcode is also handy in documentation because it is easy to pass to another editor without explaining the interface.

The main shortcode risk is losing the connection between the code and the actual slider. If you delete the slider or move it to another site with a different ID, the old shortcode may stop showing the intended block. So when moving between sites, use slider export and import carefully, and confirm that Carousel Addon is active before import. Otherwise the addon settings may not come through correctly.

Widget Use and Slider Uniqueness on the Page

The Soliloquy widget documentation shows how to add a slider to a widget area through Appearance -> Widgets. It also includes an important warning: if the same slider is already present on the page and you try to display it in a widget on that same page, it will not be duplicated because each slider must have a unique ID. For carousels, this is a common trap.

If you need a similar carousel in the content area and in the sidebar, create a separate slider or design the output so the same ID is not repeated on one page. This matters even more on pages with template-driven blocks, where a widget may appear automatically next to the main content.

Practical Scenario: A Portfolio Carousel on a Service Page

Let us walk through a real example. A studio website has a service page that already includes text, benefits, and a lead form. The goal is to add a compact carousel of project samples so visitors can see 6-8 examples without opening a separate gallery. The objective is not to create a "nice animated block," but to provide visual proof of quality while keeping the page fast.

Practical Soliloquy Carousel example for a portfolio on a service page
Practical scenario: prepared images go into the slider, carousel settings control the density, and the page displays a clear result.

Goal

Create a carousel in the middle of the service page: 4 items in the wide version, 2 on tablet, and either a standard slider or one large item on a phone, with short captions and links from each slide to a detailed case study. Visitors should understand the style of the work in a few seconds and be able to open a specific example if they want to.

Preparation

Collect images with the same proportions. If the source files differ, prepare copies in advance: do not leave important faces, products, or details right on the edge, because the carousel may crop the frame to the specified size. Give the files clear names, but do not stuff them with keywords. In the media library, fill in the alt text and caption if needed.

Create a draft page for testing. Move the carousel to the live page only after you have checked it. If the site uses caching, temporarily disable JavaScript combining for the test page or at least have a reliable way to clear cache after every change.

Setup Steps

  1. Open Soliloquy and click Add New.
  2. Name the slider so it is easy to find, for example "Service Portfolio - Carousel."
  3. Add images from the media library or upload the prepared files.
  4. Using the edit icon on each slide, fill in the alt text, a short caption, and the case study page URL if you need a link.
  5. On the Carousel tab, enable Enable Slider Carousel?.
  6. Set an item size that preserves the meaning of the frame and a moderate amount of spacing between items.
  7. Set the minimum and maximum number of visible items. For a service page, start with a range that does not make the frames too small.
  8. Choose a one-item shift per animation so the visitor does not lose context.
  9. On the Mobile tab, decide whether you actually want the carousel on mobile. If the cards become too small, leave the phone version in standard mode.
  10. Click Publish or Update, insert the slider on the test page using the Soliloquy block, and check the result.

Validation

Open the page in a separate browser window, not just in the editor preview. Make sure the carousel loads without a long loading indicator, the arrows or swipe gestures work, the images are not stretched, the captions do not cover important parts of the frame, the links go to the correct pages, and the block height does not jump after load.

Then reduce the window width or use responsive view. At mobile width, test two scenarios: carousel enabled and standard slider mode. A carousel is not always better on a phone. If the items become tiny and the user still has to move through them one by one, the standard slider may be easier to understand.

A Detail People Often Miss

If the page already contains heavy images, video, a map, a form, and analytics, the carousel can become the last element that pushes the page into feeling slow. Do not judge the result by visuals alone. Check the Network tab in browser tools or PageSpeed Insights, see which images load immediately, and ask whether all 8-10 slides really need to be in the first screen.

Mobile Version, Speed, and Layout Stability

A carousel almost always looks convincing on a wide screen, but the real test begins on a phone. The official Carousel Addon documentation specifically mentions the setting in the Mobile tab: you can allow the carousel on mobile devices, and if you do not enable that option, the mobile output falls back to a standard Soliloquy slider. That decision should be intentional.

On mobile, a carousel has three main risks. First, the items may become too small. Second, the carousel swipe gesture may conflict with the page's vertical scrolling. Third, the block may load too many heavy images for something the user may never even swipe through. So mobile configuration should be part of the usage scenario, not just a checkbox so it "matches desktop."

When to Keep the Carousel on Mobile

A mobile carousel makes sense if each item remains large enough, the caption stays readable, and swiping does not interfere with page scrolling. For example, a set of logos, simple cards, or small visual previews can work well. But a detailed portfolio, complex products, and video often work better as one larger slide at a time.

How to Reduce the Risk of Layout Shift

Web.dev lists dimensionless images among the common causes of layout shift. In Soliloquy's case, that is tied to the image dimension option and consistent slide proportions. If the carousel appears below the text and pushes nearby blocks after loading, users can miss a button or lose their reading position. On a commercial page, that is not a minor issue.

Check three things: consistent source proportions, enabling image dimensions where appropriate, and the absence of theme CSS that forcefully changes slide height. If you use a CDN or image optimizer, make sure it delivers versions that do not break the crop defined by Soliloquy.

Cache and JavaScript Optimization

Many carousel issues look like plugin errors but are actually caused by script combining, delays, or deferred execution. If the carousel renders as a static image list, shows an endless loading indicator, or stops responding to arrows, temporarily disable JavaScript optimization on the test page and check again.

You do not need to give up caching forever. You need to find the conflict. Often it is enough to exclude the slider scripts from deferred loading or clear cache after saving settings. If several optimization plugins are active at once, troubleshooting becomes harder. Keep one tool in place and test changes one by one.

Product-Specific Scenarios: What to Show in the Carousel

One of the most common carousel mistakes is thinking only about the scrolling mechanic. In practice, Soliloquy Carousel performs best when each slide has a clear role in the user journey. If you just add random images from the media library, the block may look active, but it will not help the reader make a decision. That is why it helps to choose a scenario first and build the slides around it before final setup.

For every scenario, ask three questions: what should the visitor understand at first glance, what should they be able to do after clicking, and what result will count as success? These questions sound simple, but they quickly eliminate unnecessary frames. A carousel should not include images "just in case." Every slide takes space, loads in the browser, and competes for attention.

Portfolio Carousel

In a portfolio, style, quality, and variety matter. For this kind of block, it is better to choose 6-10 strong images that do not repeat each other. If all the frames look too similar, the visitor will not learn anything new after the third slide. If the proportions vary too much, the carousel will crop important details. Prepare the images in advance: consistent color balance, matching orientation, and a clear focal point inside each frame help more than elaborate animation.

Portfolio links should point to separate case studies, not one generic page. If a visitor is interested in a specific example, they expect to see details about that exact project. In the slide metadata, add a short caption: project type, city, service, or task. Do not turn the caption into a paragraph. The carousel should open the door to the story, not tell the whole thing.

Product and Collection Carousel

For product selections, a carousel works like a compact storefront. Here, consistent imagery and clickability matter most. If one product is photographed on a white background, another in an interior, and a third in portrait format, the block will look random. It is better to prepare cards in one visual style or use images that already work well in the catalog.

Soliloquy Carousel does not replace a full online store and should not pretend to be a shopping cart. Its job is to showcase a selection and send the user to the product, category, or case study page. If the site uses WooCommerce, do not manually write stock status, price, or other dynamic states into the carousel if those values change often. Send the visitor to the current product page, where the store updates that information through its normal mechanisms.

Video Carousel

The official Carousel Addon page states that the carousel can be used with video. But video scenarios require care. Video is heavier than images, may conflict with autoplay behavior, and sometimes requires extra testing on mobile devices. For a video carousel, it is better to use clear poster images and short captions, and not place the videos in the first screen if the page is already heavy.

Make sure the carousel does not start moving unexpectedly when the user interacts with a video. The main Soliloquy changelog includes fixes related to video and transitions, so on older installations these scenarios should be tested especially carefully. If the video matters more than the carousel itself, consider using a dedicated video block or a separate playlist page.

Logo and Trust-Signal Carousel

Client, partner, or media logos are often requested in carousel form. The main risk here is turning calm credibility signals into an overly active block. Logos usually do not need long captions or dramatic effects. What they do need is equal padding around each logo, a neutral background, and a sensible scrolling pace.

If there are only a few logos, a static grid may be better than a carousel. A carousel makes sense when there are enough items that a static display would crowd the page. Even then, do not bury the strongest logos deep in the scroll: the first visible items should be the most recognizable and persuasive ones.

Migration, Updates, and Maintaining Carousels on a Live Site

A carousel is often configured once and then forgotten. A few months later, the theme changes, a new caching setup is enabled, WordPress is updated, someone deletes an image from the media library, and the block suddenly starts behaving differently. To keep Soliloquy Carousel manageable, include it in the site's normal maintenance process.

Start with clear names. A slider name should answer the question "where is this used?" If the Soliloquy list contains "New Slider," "Test," "Home 2," and "Copy," an editor will eventually update the wrong block. A better name may be longer, but it is more useful: "Design Service - Portfolio - Carousel" or "Home Page - Client Logos - Carousel."

How to Move a Carousel Between Sites

The Soliloquy documentation describes slider import and export through the Misc tab: export creates a JSON file, and import loads the settings and images. With Carousel Addon, the order matters: the required addons must already be active on the new site before import. The official import FAQ notes that addon settings may fail to import if the addons themselves are not active in advance.

In practice, that means the following: first install core Soliloquy, activate Carousel Addon, verify that a basic slider works, and only then import the JSON file. After import, open the Carousel tab and confirm that the carousel checkbox and settings were preserved. Do not stop at the message saying the import completed. The visual result on the public page matters more than the admin notice.

What to Check After Updates

After updating WordPress, the theme, Soliloquy, Carousel Addon, a caching plugin, or a CDN plugin, open the page with the carousel and check the basic path: loading, scrolling, clicking, and the mobile view. It only takes a few minutes, but it can save hours if visitors later discover a broken block on an important page.

Pay special attention to updates related to the block editor, user permissions, lazy loading, WebP/HEIC, shortcode output, and cache compatibility. The Soliloquy changelog includes fixes in these areas. You do not need to rewrite the article or change settings after every release, but you should understand which areas are most likely to be affected.

Editorial Content Maintenance

A carousel can go stale for editorial reasons as well as technical ones. Portfolio sections accumulate old projects, product selections lose items, and logo blocks may still include clients you no longer have permission to show publicly. Every few months, review the slider like an editor would: are the images still current, do the links still work, are the captions still accurate, and is the order still right?

If a slide is no longer needed, it is better to remove it from the slider than just leave it at the end. Long carousels are rarely viewed all the way through. Six strong items are better than 18 random ones. If you need to keep an archive, create a separate gallery or case study page, and let the carousel feature only the freshest and most representative material.

User Permissions and Workflow

If several editors work with carousels, decide in advance who is allowed to change settings and who should only update images. Width, height, spacing, and mobile behavior affect the entire block. One careless experiment can damage the page more than replacing a single image. For editors without a technical role, prepare a short internal guide: how to replace a slide, how to fill in alt text, and how not to change the Carousel tab without approval.

This structure matters even more on client websites. Soliloquy is appreciated for its accessible interface, but an easy interface does not remove responsibility for page structure. The clearer your maintenance rules are, the less likely it is that a clean carousel will turn into a long strip of unprepared images a month later.

Fine Visual Tuning Without Editing Plugin Core Files

After the basic setup, you may want to align the appearance with the theme: spacing, caption background, arrow states, or overall block alignment. Do this safely. Do not edit Soliloquy files, your parent theme, or WordPress core. Use custom CSS in a child theme, in the theme settings, or under Appearance -> Customize -> Additional CSS, if that path is available.

The official Carousel Addon changelog mentions the addition of the soliloquy-carousel class on the container. That gives you a safe target for CSS adjustments: you can limit changes to carousels only without affecting every other Soliloquy slider. Before adding CSS, open developer tools and confirm that the required class is actually present in your page markup.

A Small CSS Adjustment for Breathing Room Around the Carousel

This example does not change the slider's mechanics. It adds vertical spacing around the carousel container and slightly softens the caption background if the theme makes the block feel too dense. Only use it after checking the actual class on the page.

.soliloquy-carousel {
  margin-top: 24px;
  margin-bottom: 24px;
}

.soliloquy-carousel .soliloquy-caption {
  line-height: 1.4;
  background: rgba(0, 0, 0, 0.58);
}

The check is simple: refresh the page, clear cache, and look at the carousel on desktop and on a phone. If the captions start covering an important part of the image or the contrast gets worse, remove the CSS and go back to the original look. Any visual change should be reversible: keep it in one place and do not mix it with a dozen unrelated experiments.

When CSS Is Not the Right First Fix

If the problem is incorrect image cropping, CSS should not be your first solution. Start with the dimensions in the Carousel tab, the proportions of the source files, and the crop settings. If the problem is that the script is not running, CSS will not help either. First find the JavaScript conflict or missing wp_footer(), and only then improve the appearance.

Checking the Result Before Publishing

Before moving the carousel onto the live page, review it as an editor, an administrator, and a visitor. The editor needs to confirm that the right slider is easy to find and update. The administrator needs to confirm technical stability. The visitor should see a clear, fast, useful block that supports decision-making instead of distracting from it.

Checking the Soliloquy Carousel result after setup
The final review connects the settings, public output, mobile behavior, speed, and possible conflicts.

What to Check in the Admin Panel

  • The slider name is clear to other editors.
  • The Carousel tab is enabled and the settings remain saved after refreshing the page.
  • Each important slide has alt text, a caption, and a URL if a link is needed.
  • The Mobile tab was configured intentionally, not left as an accident.
  • If the slider was imported from another site, all required addons were activated before import.

What to Check on the Public Page

  • The carousel appears without an endless loading indicator.
  • The first visible set of items looks even, with no unexpected cropped faces, products, or text inside the image.
  • Arrows, swipe gestures, and links work where they are supposed to work.
  • The mobile version does not trigger horizontal scrolling for the entire page.
  • After clearing cache, the result matches what you saw while logged in as an administrator.
  • Nearby page blocks do not jump when the images load.

If the carousel appears next to an inquiry button, a form, or a purchase block, test the full user path. Visitors should be able to view examples, browse them, follow the right link, or continue reading. If the carousel grabs too much attention and interferes with the page's main goal, reduce the number of items, disable autoplay movement, or move the block lower.

Short version: a good carousel does not prove its value through the number of effects. It proves it by helping users understand the collection faster and move to the next action without friction.

Common Soliloquy Carousel Problems and Troubleshooting

Carousel issues are rarely mysterious if you break them down by layer: content, slider settings, page output, theme, cache, and outside optimizers. The official Soliloquy troubleshooting documentation lists common failures: images do not load, metadata does not save, the slider does not appear, the loading indicator hangs, the position renders incorrectly, transitions look jerky, centering breaks, or cropping fails under certain CDN scenarios. With Carousel Addon, those symptoms need to be read through the lens of a multi-item carousel strip.

The Carousel Tab Did Not Appear

Symptom: the addon appears to be installed, but when editing a slider there is no Carousel tab or no Enable Slider Carousel? option.

Possible cause: Carousel Addon is not activated, not available at the current access level, the edit page was opened before activation, or core Soliloquy is running in a limited mode. In some cases, administrators confuse Lite and Pro features because WordPress.org describes Pro capabilities, but the specific addon requires the appropriate access level.

What to check: the Soliloquy -> Addons section, the button state for Carousel Addon, the presence of an active core installation, and the absence of an old conflicting package.

How to fix it: activate the addon through the official screen, refresh the slider editing page, and verify your access level. If the tab still does not appear, temporarily disable other plugins on a test copy and check the theme using the standard conflict-isolation approach.

The Carousel Displays as a Standard Slider on Mobile

Symptom: on desktop you can see several items, but on a phone only one slide appears like a standard Soliloquy slider.

Possible cause: the option to use the carousel on mobile devices is not enabled in the Mobile tab. The Carousel Addon documentation explicitly says that without this checkbox, the mobile version will fall back to a standard slider.

What to check: the Mobile tab in the settings for that specific slider, then the public page in a mobile-width view.

How to fix it: enable the mobile carousel, save the slider, and clear cache. If the items become too small, roll the setting back and keep the standard mobile mode. That is a perfectly valid choice, not a failed setup.

The Loading Indicator Hangs or the Carousel Does Not Move

Symptom: instead of a working carousel, you see a loader, a static list of images, or a block that does not respond to arrows or swipe gestures.

Possible cause: a JavaScript error, a theme or plugin conflict, browser cache, deferred script loading, or missing footer script output in the theme.

What to check: the browser console, temporarily disabling JavaScript optimization on the test page, the presence of wp_footer() in the theme, and conflicts with cache or minification plugins.

How to fix it: clear cache, disable questionable optimization, and test with a default theme in a test environment. If the issue disappears, re-enable extensions one at a time. Do not edit plugin core files or manually remove Soliloquy scripts.

Images Are Cropped Differently Than Expected

Symptom: an important part of the photo disappears, a product gets cut off, faces end up near the edge of the card, or different slides look uneven.

Possible cause: Carousel Addon uses the defined image width and height with cropping. Source files with different proportions are forced into one format. Cropping can also be affected by a CDN or image optimization layer if it serves original dimensions instead of the prepared ones.

What to check: the original file proportions, the width and height settings in the Carousel tab, the image dimension option, and how the CDN or image optimization module behaves.

How to fix it: prepare source files with similar proportions, adjust the item size, and disable the conflicting CDN module for testing. If the frames differ too much in meaning and composition, split them into two separate carousels.

Transitions Look Jerky or the Block Is Not Centered

Symptom: the carousel jerks while scrolling, items are shifted, or arrows and captions look out of place.

Possible cause: the theme CSS overrides Soliloquy styles, adds margin or padding to slider elements, changes the container width, or affects positioning.

What to check: DevTools, container styles, the Configuration tab for slider position, and theme rules that affect images, lists, or links inside the carousel.

How to fix it: first identify the conflicting rule, then add targeted CSS through a child theme or Additional CSS. If the change makes the mobile version worse, remove it and adjust the slider settings instead of trying to overpower everything with CSS.

The Same Slider Does Not Appear Twice on One Page

Symptom: the carousel appears in the content area but not in the widget, or the other way around.

Possible cause: the Soliloquy widget documentation states that the same slider should not be duplicated on a page: each output needs a unique ID.

What to check: whether the same slider has been inserted through a block, shortcode, and widget at the same time.

How to fix it: use a single output on the page or create a separate slider for the second placement. After making the change, clear cache and confirm that the two blocks no longer conflict.

Who Soliloquy Carousel Is a Good Fit For, and Who Should Choose Another Route

Soliloquy Carousel is a good fit for sites that already use Soliloquy or need a manageable visual carousel without a heavy animation builder. It is easy for editors to understand: create a slider, add images, enable the carousel, set the dimensions, and place the block on the page. That is enough for portfolios, compact galleries, product selections, and visual proof sections.

The plugin may not be the best fit if you need a full visual layer editor, complex animated scenes, cinematic hero sections, or deep per-device control over every state. In those cases, heavier visual builders are often a better direction. But that extra flexibility comes with a more complex interface, longer setup time, and greater performance optimization demands.

You should also be cautious if the site already runs several slider plugins, a separate lightbox, aggressive JavaScript minification, and CDN-based image processing. A carousel does not have to break the site on its own, but it does add another interactive layer. The more layers you add, the more important a test page, a backup, and step-by-step troubleshooting become.

If you are comfortable working within the Soliloquy workflow and specifically need carousel mode for an existing set of slides, you can download the installation file and test it on a copy or draft page. Do not move the block onto an important landing page until you have checked mobile output, cropping, links, caching, and theme behavior.

Soliloquy Carousel FAQ

Can I use Soliloquy Carousel without the main Soliloquy plugin?

No. According to the official product logic, this is an addon for Soliloquy. You need the core plugin and a working slider first, then Carousel Addon adds carousel mode to that specific slider.

Why does the carousel not work in the free version the way it is described in the Pro features?

On WordPress.org, Soliloquy Lite is presented as a lighter version, while the Pro ecosystem includes additional features, including the carousel. The Carousel Addon documentation separately lists the required access tiers. If the required addon is missing from the Addons section, check whether the feature is available for your installation.

Do I need to enable the mobile carousel?

Not always. If the items stay large enough on a phone and swiping feels natural, enabling it makes sense. If the cards become too small, it is better to keep the standard mobile slider. The documentation confirms that without the mobile checkbox, the carousel on mobile will display as a regular Soliloquy slider.

Why are the images in the carousel being cropped?

The width and height settings in the Carousel tab are used with cropping. That helps create a clean, even strip, but it requires well-prepared images. If important details sit near the edges, prepare the frames in advance or adjust the item dimensions.

Can I insert the carousel into the block editor?

Yes. The Soliloquy documentation shows block usage in Gutenberg: after publishing the slider, you can add the Soliloquy block to a page or post and choose the required slider from the list. A shortcode option is also available.

What should I do if the carousel does not load after caching is enabled?

First clear the browser and site cache, then temporarily disable deferred loading or JavaScript combining on the test page. If the problem disappears, create an exclusion for the slider scripts or reduce the aggressiveness of the optimization. Do not edit plugin files.

Can I display the same slider twice on the same page?

The Soliloquy widget documentation warns that the same slider should not be duplicated on a page: each output should have a unique ID. If you need two similar blocks, create a separate slider or change the page structure.

Is Soliloquy Carousel good for SEO?

A carousel on its own does not guarantee better rankings. It helps if it improves the page: it shows relevant images, has meaningful alt text, does not hurt speed, does not cause layout shifts, and does not hide important text. Any SEO effect depends on content quality and technical implementation.

When Soliloquy Carousel Is the Right Choice

Soliloquy Carousel is worth using if you need a manageable, understandable, and reasonably lightweight carousel inside WordPress, especially on a site that already uses Soliloquy. The addon's real strength is not that it turns a page into a complex animated scene, but that it gives editors a concrete tool: take a set of slides, control the density of the strip, enable the desired mobile behavior, and place the result exactly where it belongs.

The best results come when you prepare images in advance, do not overload the block with captions, test mobile mode, handle caching deliberately, and avoid trying to fix carousel settings with random CSS. In that setup, the carousel helps the page: it saves space, presents a series of materials, guides users to case studies or products, and does not break the main user journey.

If the carousel looks clean after testing, loads quickly, does not conflict with the theme, and genuinely helps visitors browse the collection, it is ready for the live page. If the block keeps requiring more workarounds, breaks the mobile version, or distracts from the main action, simplify the solution instead: a standard slider, a static gallery, or a separate portfolio page is often the more honest and reliable choice.

By OceanTheme.org Editorial Team

 

You are not logged in to post comments.