In this article you will learn how to migrate to Jupiter V5, taking into account all of the changes that need closer inspection. We anticipate the migration process to be the smoothest ever and It will be just like another theme update. The only thing that might be time consuming during the migration is if you have modified the theme in a child theme. To make sure you complete the migration with the least amount of hassle, we have listed all the things you need to be aware of before upgrading below:

Jupiter V5 Server Requirements

Before upgrading to V5.0 make sure you server complies with WordPress environment requirements. We have been using some OOP technics and standards that are not present in php legacy versions (e.g. v5.2.X, v5.3.X). Minimum required version is PHP V5.4+

Update using Envato Toolkit

Migration from Jupiter V4.X to Jupiter V5 will not be possible through Envato Toolkit. So you should update it manually using Appearance > Themes > Install Theme.

Update Visual Composer

Jupiter V5 will only work with Visual Composer V4.7.5+ so make sure you will update it from Appearance > Install Plugins

Clear Theme Cache

In Jupiter V5, we store theme options generated styles, used components assets (Javascript and Styles) into single CSS and JS files. These changes to the theme decrease the page loading time. We collect the features that are being used in a website into a database and keep track of them while you use the site. However in some cases you may need to click on the Clear Theme Cache button. This link appears in the WP header toolbar and you should be logged in as an administrator to see it. This button will flush all stored data as well as static files. In each page visit the content will start to be shaped and generate the static files based on your usage. This feature is still in its beta stage and if you encounter any issues please report it to Artbees Helpdesk.

Background Selector Patterns
Background Selector PatternsA comparison between old and new background selector

Patterns in background selector

To create a lighter WP, which is easier to use, we have removed the predefined patterns and textures from background selector.  As you can see in the image below you are given only Custom and No Image options (comparing to V4 where you could also choose from predefined patterns).

For those who have used patterns in both Theme Options or Post/Page Meta Options please follow the process below:

  1. From the main package zip file you downloaded from ThemeForest, find patterns.zip
  2. Unzip the package and find the patterns you have used in your site
  3. From background selector module upload the pattern using the custom method.
  4. Repeat this process for all locations where you have used predefined patterns.
Background Selector Patterns
Background Selector PatternsA comparison between old and new background selector

Patterns in Page Section & Custom Box Shortcode

As with the background selector module, Patterns are removed from Custom Box and Page Section shortcodes. As you can see in the image below, the Background Pattern option is no longer available in V5 page section options.

For those who have used patterns in both Page Section or Custom Box Shortcodes please follow the process below:

  1. From the main package zip file you downloaded from ThemeForest, find patterns.zip
  2. Unzip the package and find the patterns you have used in your site.
  3. Visit your pages and find locations where you see missing images.
  4. Edit shortcode and upload your patterns and choose the one you used in V.4
  5. Repeat this process for all locations where you have used predefined patterns.
Page Section Background pattern option
Page Section Background pattern optionThis option has been removed in Jupiter V5

Remove Space before and after Page Section options

These options were deprecated in Jupiter V4.x and have been removed in V5. You will need to use the stick template option in post meta options to remove space between page sections.

Remove space before and after Page Section
Remove space before and after Page SectionThese options were deprecated and have been removed in Jupiter V5

Removal of iCarousel slideshow from theme core features

We have removed the iCarousel slideshow, post type, shortcode from the theme base feature due to minimum usage by our users. We will convert it to a Jupiter Addon and introduce it very soon to the collection. If you are using this module in site, stay tuned for Jupiter V5.1

Slideshow settings & Jupiter Video banner Metaboxes

The meta options below were long deprecated and have finally been removed in V5. You can use Visual composer to create slideshows and page section shortcode for having video banner layers. We have removed them to increase rendering speed in post editing.

Jupiter Slideshow Settings
Jupiter Slideshow SettingsThe above meta options have been removed and you will need to use visual composer to add your slideshows
Jupiter Video Banner Settings
Jupiter Video Banner SettingsYou can use page section to generate the same look

Theme Options > Header > Start Tour Page option needs update.

The “Start a Tour” module located in the header will need to be checked for option modifications. If you compare the screenshots below, you will notice you used to choose from options to select a link. However, in V5 you will need to paste a URL in the text field.

Start a Tour
Start a TourThis feature needs updates if you are using it in your website.

Font Weights might be reset in some Theme Options Typography

In order to support the whole range of font weights starting from 100 to 900 font weights, we have added many more options. You may experience some font weight options being reset. Make sure you keep track of them before you update so you can check and set them again if required.

FontFaces have been removed

We have removed “Self Hosted FontFaces” from theme as they seem to be one of those deprecated typography technologies. Instead we only offer full list of Google Fonts, Typekit and of course Safe Fonts. If you still wish to use a FontFace you will need to install Use Any Font plugin which offers custom font upload.

Child theme and shortcode override changes

If you have ever overridden Jupiter shortcodes in a child theme, there are a couple of things you need to do before migrating to Jupiter V5!

In V4.X and older versions the folder structure for shortcodes was as follows: shortcodes/shortcode_name.php

In V5.X we have changed it to “architecture by feature” meaning that its configurations, styles, scripts and shortcode options stay on the same folder. You can also override its assets and options as well (which was previously not possible).

Old Method :

jupiter/shortcodes/mk_button.php

New Method :

jupiter/components/shortcodes/mk_button/mk_button.php

jupiter/components/shortcodes/mk_button/mk_button.css

jupiter/components/shortcodes/mk_button/vc_map.php

jupiter/components/shortcodes/mk_button/config.php

Shortcodes Architecture
Shortcodes ArchitectureOverriding shortcodes in Jupiter V5 is a different process

Woocommerce Single Product Image Size

In Jupiter V5 the WooCommerce single product image size is being managed from the location shown below. If you see quality loss in the image, simply go to the WooCommerce settings and change the size to 550×550 pixels.

WooCommerce Single Image Size
WooCommerce Single Image SizeImage size is now being managed by WP native resize.