Skip to content

Upgrading to v2

Carousel Slider Block v2 uses Swiper.js for improved performance, touch support, and broader compatibility.

Existing Legacy Blocks

Existing legacy Carousel Slider blocks will continue working as usual.

Legacy carousel blocks are hidden from the block inserter by default. If you need them again, open /wp-admin/options-general.php?page=cb-carousel-settings and enable Show old carousel blocks.

Upgrade a Legacy Carousel

  1. Open the post or page that contains the legacy Carousel Slider block.
  2. Select the legacy carousel block.
  3. In the block toolbar, click the block icon on the left.
  4. Choose Transform to Carousel Slider.

Your carousel settings are preserved during the upgrade, but the frontend markup and visual output will change in v2.

After Upgrading

Check the updated carousel layout and styling after the transform. If you added custom CSS for the legacy version, you may need to adjust it for v2.

Legacy Support Settings

You can manage legacy support from /wp-admin/options-general.php?page=cb-carousel-settings in the WordPress admin.

From there you can:

  • show old carousel blocks in the inserter again
  • disable legacy support if you no longer need it
  • hide upgrade notices for legacy blocks

Important

Legacy blocks are no longer actively supported. For best compatibility and future updates, upgrading to v2 is strongly recommended.