Back to Community

Troubleshooting Parallax and Background Image Issues on Mobile with Kadence Blocks

Content

Many users of the Gutenberg Blocks with AI by Kadence WP plugin encounter a common challenge: background images, particularly those with parallax or fixed effects, behave unexpectedly on mobile devices. This can manifest as images not appearing, appearing blurry, flickering, or incorrectly applying the effect to the entire page instead of just the row. Based on community support threads, this article explains why these issues occur and outlines the most effective solutions.

Why This Happens

The core of the problem often lies in how mobile browsers handle certain CSS properties for performance reasons. A key example is background-attachment: fixed. To preserve battery life and ensure smooth scrolling, many mobile browsers simply do not support this property. When the plugin or your theme tries to apply it, the browser ignores it, leading to a default scrolling background instead. Parallax effects, which rely on JavaScript, can also conflict with browser optimizations on iOS and Android, causing them to break, flicker, or not render images until the page is scrolled.

Common Solutions and Workarounds

1. Use Parallax Instead of Fixed on Mobile

Since background-attachment: fixed is unsupported on mobile, the recommended approach is to use the parallax effect for mobile backgrounds. The Kadence Row Layout block allows you to set a different background image for tablet and mobile views. For the best results:

  • In your row's Background Settings, scroll down to Background Attachment.
  • For the mobile device view, set the attachment to Parallax instead of Fixed or Scroll.
  • Ensure you have uploaded an appropriately sized image for mobile in the dedicated mobile background image setting.

2. Apply Custom CSS for Specific Issues

For persistent issues on specific devices (like older iPhones or iPads), custom CSS can often help. For example, one user found the following code resolved a flickering parallax issue on iOS:

@media not all and (min-resolution:.001dpcm) {
    @supports (-webkit-appearance:none) {
        @media (max-width: 1024px) {
            .wp-block-kadence-rowlayout [id*="jarallax-container-"] {
                clip: auto !important;
            }
        }
    }
}

You can add this by navigating to Appearance > Customize > Additional CSS in your WordPress dashboard.

3. Disable the Background Entirely on Mobile

If a background image simply doesn't work well on a small screen, you can hide it. The easiest method is to use the Row Layout block's built-in visibility settings. Within the row's settings, navigate to the Visibility tab where you can toggle the block's visibility for desktop, tablet, and mobile. Alternatively, you can use CSS:

@media (max-width: 768px) {
    .your-specific-row-class {
        display: none;
    }
}

To find the correct CSS class or ID for your row, you may need to inspect your page using your browser's developer tools.

4. Check Image Sizes and Caching

Blurry images on specific devices like iPhones are often related to image size and how the browser selects which image source to load. Ensure you are using high-resolution images that are appropriately sized for the container. Furthermore, clear any caching plugins or server-level caches after making changes to your background settings, as old cached versions of the page can sometimes cause display issues.

Conclusion

Mobile browser limitations are the primary cause of background image quirks. The most reliable solutions involve using the Parallax setting for mobile, leveraging custom CSS for specific bugs, or hiding problematic elements altogether. While the Gutenberg Blocks with AI by Kadence WP team has addressed many of these concerns over time, understanding these workarounds is key to creating a seamless responsive experience for all your visitors.

Related Support Threads Support