Troubleshooting
If you are facing a technical issue with the Divi Carousel Maker, please check the troubleshooting steps listed below. If the outcome of following the steps below points to an issue with our plugin specifically, please send us a support message. When you reach out for support, we will ask about the results of these troubleshooting steps to better understand and resolve the issue.
👉 General Troubleshooting Steps
Step 1: Deactivate All Plugins Except Divi Carousel Maker
When troubleshooting an issue with our plugin, it’s essential to determine whether there is a conflict with another plugin. To do this, please deactivate all other plugins on your site, leaving only the Divi Carousel Maker active. If deactivating the other plugins resolves the issue, it indicates a conflict with one of them.
To identify which plugin is causing the conflict, start by reactivating each plugin one at a time. After reactivating each plugin, refresh the page to check if the issue still happens. Continue this process until you find the plugin that triggers the problem.
Once you’ve identified the conflicting plugin, please let us know the details so we can provide further assistance.
If the issue is still happening with only our plugin active, it suggests the problem may not be related to a conflict and will require further investigation.
Step 2: Deactivate Our Divi Carousel Maker Plugin
Please temporarily deactivate the Divi Carousel Maker to confirm whether our plugin is causing the issue. While this may seem counterintuitive, it is an important step to verify if the problem is related to our plugin.
If the issue persists after deactivating our plugin, it suggests that our plugin is not the cause. Conversely, if the problem only occurs when our plugin is active, it indicates that our plugin might be involved and will require further investigation.
🔧 Common Issues
Below is a list of common issues you may encounter when using this plugin. Please review the solutions or explanations provided for any issues that are relevant to your situation.
Space Below Carousel With Portfolio Modules
There can sometimes be extra space showing below the carousel when you are using the Divi Portfolio module to display projects. This issue happens because of the way Divi loads their Portfolio module. It’s a technical issue, but to try to explain, they load the images initially as full height, which in the code looks like the module is taller. Then our carousel finds their height and calculates the height for the carousel accordingly, but as you are seeing it is not correct.
Solution
To solve this, we have added a new max height setting to the carousel in the Miscellaneous toggle. This allows you to set the maximum height of the carousel. The value will vary, depending on your specific carousel, based on the height of the modules and content within it. You could try guessing the best value or use trial and error by starting with something like 250px and see how it looks, and adjust as needed, but the best way to choose a value to enter into this field is to use the browser inspect tools and check the actual height of the carousel.
The Carousel Is Not Working
Occasionally we get a customer support ticket about the carousel not working, or it suddenly stopped working for no apparent reason. But every time this happens, it is always related to something blocking our carousel on the customer site. 99% of the time, caching and optimization plugins are the culprit. Just recently, someone realized that their Asset Cleanup plugin was removing/blocking our plugin’s code. Others have had a caching plugin strip our CSS class from the column, but the class is used to make the carousel work. In each of these cases, the issue is not related to our plugin, but to an external force incorrectly affecting it.
We had a customer who could not get the carousel to work on actual mobile devices, but it worked fine on desktop and in the browser preview. We figured out the issue was related to the optimizer plugin blocking our code. Below are some examples that we know about so far.
Siteground Optimizer
To solve this issue, go to Siteground Optimizer > Frontend from the WordPress message. Then look for the Exclude from Deferral of Render-blocking JS option and click the edit icon. Then select the /wp-includes/js/jquery/jquery.min.js option and click Confirm.
WP Rocket
A customer using WP Rocket sent us these instructions:
1. Open your WP Rocket settings in your WordPress dashboard.
2. Navigate to the “File Optimization” tab.
3. In the “Excluded CSS Files” section, add the following URL:
*/wp-content/plugins/divi-carousel-maker/styles/style.min.css*
4. In the “Excluded JavaScript Files” section, add the following URLs:
*/jquery-?[0-9.](.*)(.min|.slim|.slim.min)?.js /jquery-migrate(.min)?.js
/Divi/js/scripts.min.js /Divi/js/custom.unified.js /js/magnific-popup.js*
5. Save your changes by clicking the “Save Changes” button.
Litespeed
A customer using Litespeed cache informed us that the setting “Generate UCSS” needs to be OFF. Otherwise, it disrupts the carousel code from working.
NOTE: Other optimization plugins may also cause this same issue, and if so the same general process can be used to exclude the JS file in other plugin settings.
Equal Slide Height Not Working
Understanding the Equalize Slide Height Feature
If you’ve enabled the Equalize Slide Height feature in the Design Settings but don’t notice a difference, it’s likely due to a common misunderstanding of how this feature works. Let’s clarify:
This setting ensures that all carousel slides have the same height, but it does not affect the height of the modules inside those slides. The slides themselves will be equalized, but the content within them may still vary in size. It would be impractical for our carousel to forcefully stretch the modules to be equal, so this feature affects this slide instead of the modules.
Analogy: Think of It Like Picture Frames
Imagine you have five identical picture frames standing on a desk. Even though the frames are the same size, the pictures inside them can be different sizes. In this analogy:
- The carousel slides are the picture frames (which can be equalized in size).
- The modules inside the slides are the pictures (which may have different heights).
To visually equalize your slides, you need to apply design settings such as background color, border, padding, or box shadow in the carousel’s Design Settings. In this case, avoid applying similar settings to the individual modules inside the slides, as that causes visual height inconsistencies.
By doing this in the carousel Design Settings instead of the module, you ensure a uniform look across all slides while still allowing flexible content inside.
Navigation Button Icons Missing Or Showing Weird Characters
If the navigation button icons are missing or showing wrong characters, this is likely due to a known conflict with Divi’s Performance features. To resolve this, follow these steps:
- Navigate to Divi > Theme Options > General.
- Open the Performance tab.
- Disable the Dynamic Icons setting.
This should restore the icons properly in the navigation buttons.
Drop Shadow Around The Carousel Is Getting Cut Off
If the drop shadow is being cut off, it’s likely due to the shadow’s spread width exceeding the available spacing. To fix this, follow these steps depending on where the shadow is being cut off:
- Entire Carousel: If the shadow is cut off around the entire carousel, increase the spacing in the Carousel>Design Settings toggle to provide enough room for the shadow so that the spacing around the carousel is greater than the shadow’s spread.
- Individual Slides: If the shadow is cut off around each slide, adjust the spacing around the individual slides in the Carousel>Design Settings toggle to provide enough room for the shadow so that the spacing around each slide is greater than the shadow’s spread.
Carousel Tab Not Showing
One of the most common questions we get is about the carousel tab not showing. Almost always, there is just a misunderstanding, as the carousel tab is located in the column, NOT in a row or module.
We recently had one support request where they could not see the tab, and found the issue was related to Divi’s cache. After deleting the et-cache folder, the tab appeared.
Person Module Stacking Wrong
When using the person module in a slideshow, you may experience an issue with images not stacking correctly. This occurs when flex is applied, which is essential for the carousel to work properly. To resolve this issue, we have added a new option in the Miscellaneous Settings section of the carousel settings. Simply enable the Person Module Stacking setting to fix the problem.
Why Some Settings May Be Missing
If you notice that certain settings are not available, it’s likely because they depend on other settings being enabled or disabled. Many settings in the Divi Carousel Maker are conditional, meaning they only appear when relevant and are hidden if they are not compatible with other selected options.
Examples of Conditional Settings:
- Navigation Buttons will be hidden if Continuous Smooth Scroll is enabled in the Scroll Settings, as this setting removes the need for manual navigation.
- Custom Slide Width cannot be adjusted if Variable Slide Width is enabled, since variable widths override custom width settings.
- Highlighted Slide Design Settings will only be available if you have a slide selected as Highlighted.
If you’re unsure whether a setting is missing due to another enabled option, you can:
- Compare with a new carousel to check the default settings.
- Reset settings to default to reveal all available options.
This conditional behavior helps keep the settings panel streamlined and ensures that only relevant options are displayed based on your current selections.
FAQs
If you have questions that are not addressed in our documentation, please review the frequently asked questions listed below. We regularly update this section based on common queries from our customers. If you don’t find the answer you’re looking for here or in our other documentation, feel free to contact us for support, and we’ll be happy to assist you.
How to make the carousel fullwidth?
Since the carousel is enabled inside a column inside a Divi row, to make a carousel fullwidth you simply need to set the green Divi row to 100% width.
How to remove spacing around the carousel or slides?
By default, the carousel features a 10px margin around the entire carousel, which can be modified using the Carousel Container Spacing inputs found in the General Settings section. Additionally, there is a 10px margin around each individual slide, which can also be adjusted through the Default Slide Spacing inputs located in the Design Settings>Default tab.
Is this a carousel module?
How does this plugin work?
The plugin adds new carousel settings directly in the existing Divi Builder! You can add any modules to a column in your layout and then turn on a switch to make them into a carousel. Then you can adjust the carousel and design settings to your own preferences. Please check our full documentation guides for more info on all the features.
Which modules can be added to the carousel?
- Blurb
- Image
- Call-To-Action
- Testimonial
- Person
- Blog
- Portfolio
- Woo Products
- Videos
- Text
But the great part is that since this is not a carousel module, any module you choose can be added.
Does JavaScript load on all pages?
Why is there no visual preview?
Please note that Divi unfortunately cannot render a preview of our custom settings inside the Visual Builder. The custom settings provided by our plugin will take effect on the frontend when you exit the builder.
In the future, we expect Divi version 5.0 to be able to render custom settings, but until then we cannot do anything about it. We recommend keeping your page open in two separate tabs in your browser, one with the Divi builder enabled, and the other on the frontend. Whenever you save changes in the builder, you can immediately refresh the other tab to see the changes take effect.
We apologize for this inconvenience, but hope you can appreciate the value of our helpful and innovative features! The unique nature of our plugin which modifies the existing Divi Builder is too far ahead of its time! 😊
Why are some settings missing?
Some settings are conditional, which means they only are relevant and only show based on other settings. You may notice that some settings are not available, and if so, this is because they are not compatible with another setting. For example, you may have a specific setting enabled in the Scroll Settings that makes other settings in the Navigation Buttons or Design Settings hide. You can always double-check this by enabling a new carousel and comparing the settings, or resetting the settings to default.
Does the Carousel work with Specialty Sections in Divi?
No, Divi Carousel Maker does not currently support Specialty Sections. Specialty Sections in Divi have a very different code structure, which is not compatible with our plugin at this time.
