# How To Update Motors

{% embed url="<https://www.youtube.com/watch?v=eSecPEnV8lc>" %}

The Motors theme update is released regularly. Each theme update includes new features, improvements to existing options, security patches, and bug fixes. To be able to use them we recommend you keep the theme installation up to date.  As soon as a new update is available, **you will be informed via email from ThemeForest**.

You can update the theme through the **WP admin panel** or via an **FTP account**. Let's have a look at all the ways so that you can choose a method that is convenient for you.

Before starting to update the theme, we encourage you to walk through the following points:

## Best Practice

* Always check our release notes - [Changelog](https://docs.stylemixthemes.com/motors-theme-documentation/changelog)

{% content-ref url="../changelog" %}
[changelog](https://docs.stylemixthemes.com/motors-theme-documentation/changelog)
{% endcontent-ref %}

* Perform **a full site and database backup.** Thus, you’re able to revert the working version of your website if anything unexpected happens during/after the update process.
* **Ensure that your server is configured to the minimum requirements** for the theme. You can see the required minimums of the server limits on the [System Requirements](https://docs.stylemixthemes.com/motors-theme-documentation/general/system-recommendations) page.
* **Reset the browser and server cache** after finishing the update.
* **Have a staging version** of your original website?  Then just run the update process first on a test website to ensure that everything is working correctly.&#x20;

{% hint style="danger" %}
**An important step before updating!**

Before the release of any update, we conduct automatic and manual testing of our theme. However, during the installation/update process, there may occur unexpected issues related to the work of other plugins or problems with the server side. In such cases, you can contact the support department for assistance.&#x20;

According to the [Item Support Policy](https://themeforest.net/page/item_support_policy) of the Envato marketplace, technical assistance is available only during the item support period. Hence, it is recommended to check the support period before updating Motors and [renew](https://docs.stylemixthemes.com/motors-theme-documentation/general/how-to-get-support#extending-and-renewing-item-support) it if necessary. &#x20;
{% endhint %}

## Update the theme via WordPress

Follow all the steps below to get notifications and smoothly update the theme directly from the WordPress dashboard. &#x20;

### Stage 1 - Update the theme

The first thing you need to do is download and install the Envato Market plugin from the official website - <https://envato.com/market-plugin/>.

{% hint style="info" %}
Since the **Motors update**, the Envato Market plugin is included in the theme and it can be installed in the Appearance > Install Plugins section. &#x20;
{% endhint %}

The plugin adds the Envato Market section to the dashboard menu. Go to the **Envato Market > Settings** to configure the plugin. &#x20;

&#x20;

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FC4UwWfn7q3pijiXGmSZI%2Fimage.png?alt=media\&token=4237d8af-d2fb-4a4c-a844-628bc31b20eb)

{% hint style="success" %}
By [clicking this link](https://build.envato.com/create-token/?default=t\&purchase:download=t\&purchase:list=t) you can get an Envato API Personal Token with all the required permissions pre-selected. You should be logging in to your Envato account.  &#x20;
{% endhint %}

{% embed url="<https://build.envato.com/create-token/?default=t&purchase:download=t&purchase:list=t>" %}

**Alternatively**, you can enable the required permissions listed below to get new updates:

* **View and search Envato sites**
* **Download the user's purchased items**
* **List purchases the user has made**

Enter a name for your personal token

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FT5zvzXw1QG7gxpP4mnpD%2Fimage.png?alt=media\&token=cdcc4267-3556-4caf-8891-3e9271cd35d1)

Accept the [Terms & Conditions](https://build.envato.com/terms/) and generate a personal token. Copy the key from the success message and click on the **Woohoo! Got It.** button to complete the process.&#x20;

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FSijjhQvpA9KAQJxJnnZQ%2Fimage.png?alt=media\&token=79d8e575-21e1-4c8a-bcce-bfa8adbf8dab)

Put the token key to the Token field in the Envato Market plugin settings and save your changes&#x20;

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2F87Vhshfy1vaWcmje4oc2%2Fimage.png?alt=media\&token=66b00e8d-bb00-47e3-b86b-4e7a46099a99)

You will be redirected to the Themes tab where you can update the theme by clicking the Update Available link&#x20;

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FwH5XbLv3xYhh3dK1YJEP%2Fimage%20\(4\).png?alt=media\&token=4c09f078-0788-4a86-9304-90d0a5f38152)

### Stage 2 - Update all plugins

When the theme update is done, you will get a notification message "**There are updates available for the following plugins:...**".&#x20;

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2FYiZQpH82RMmp0JSDyYmE%2Fimage.png?alt=media\&token=b9d5110b-334c-4bf1-af39-80df9fc1d6a9)

{% hint style="warning" %}
After updating the theme it is required to update bundled core plugins in Motors > Plugins section. The site administrator will be redirected to this section until they are updated.
{% endhint %}

Navigate to **Motors > Plugins** and click **Update Available**. You'll need to update all the plugins in this section.&#x20;

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDP3ivYPbpYO9Rs_wuB%2Fuploads%2Fj5K7rNPeRcIOwKytAvsb%2FPlugins-update-available_2.png?alt=media\&token=e5303685-96ad-480e-80ff-7b917d982806)

{% hint style="warning" %}
**NOTE:** Licence code for WPBakery Page Builder, Slider Revolution, and Subscriptio is not included.  However, you can use them freely or activate your personal license (if you have one) to get plugins updates. This is the Envato policy, also authors of these plugins do not allow any theme developer to provide Purchase Code for third-party plugins. Some of them might have messages requiring activation, but they are already activated on our side. \
Anyway, **we provide plugins' latest version within theme** **update** so your website will always be updated and secure.
{% endhint %}

## Update the theme via FTP (Expert)

Sign in on the [ThemeForest account](https://themeforest.net/) that purchased the Motors theme. On the user's menu open the Downloads section.

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDP3ivYPbpYO9Rs_wuB%2F-Mhrve9XdGOeY9hdM18W%2F-Mhrzd9v5k1fdkMsN18U%2Fenvato-profile-menu.png?alt=media\&token=770b2972-88ff-4774-adaa-141bbcb9bf0e)

You will be taken to a page with purchased items where the Motors theme is located. Click the **Download** button and select the **Installable WordPress file only** option. Thus the theme zip archive file (**motors.zip**) will be downloaded to your device.

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDP3ivYPbpYO9Rs_wuB%2F-Mhrve9XdGOeY9hdM18W%2F-MhrztaK1F4_WnHUSraX%2Fmotors-download.jpeg?alt=media\&token=aef1c022-8be1-473b-bfae-8562cbc7ceae)

Unzip the **motors.zip** file which will give a Motors folder. Make sure your unzipping software does not create an extra directory with the same name nested into each other.

{% hint style="warning" %}
**NOTE:** Place your site in maintenance mode using a special plugin ([WP Maintenance Mode](https://wordpress.org/plugins/wp-maintenance-mode/), [Maintenance](https://wordpress.org/plugins/maintenance/), etc.)
{% endhint %}

Retrieve your FTP login information from your hosting admin panel. Login to your FTP account via an FTP software ([FileZilla](https://filezilla-project.org/download.php) or similar) to access your website folders.

![](https://2954064479-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDP3ivYPbpYO9Rs_wuB%2F-MfWAGAZB5-z9I017yMl%2F-MfWMmEInnyzLRbNO-IO%2Fftp.png?alt=media\&token=dd90c85c-cb7c-4b69-9cf2-8a1376c088a8)

Once you access the FTP account, navigate to the WordPress theme directory ***YOUR\_HOSTING\_ROOT/YOUR\_SUBDIRECTORY/wp-content/themes*** and remove the **motors** folder. &#x20;

Upload by drag and dropping the previously unzipped **motors** folder into ***YOUR\_HOSTING\_ROOT/YOUR\_SUBDIRECTORY/wp-content/themes*** directory. &#x20;

Congratulations, you have successfully updated the theme! Also, **don’t forget to update the required plugins under the Appearance > Install Plugins section.**&#x20;

{% hint style="info" %}
**Is it safe to remove the theme folder?**

Removing the theme folder doesn't delete your current content and settings as they are located in the database. If you made custom changes in core files, then the update will override your modifications. Therefore, you should back up those files beforehand or use a child theme.
{% endhint %}

## Child Theme

**The child theme doesn’t need to be updated!** &#x20;

Whenever we make major changes to a certain part of the parent theme, you’ll have to check our [release notes](https://docs.stylemixthemes.com/motors-theme-documentation/changelog) and compare the file from the parent theme with the modified one in your child theme. If necessary apply the customizations or modifications again. If you don’t do this, there’s a chance that your custom code (function, feature, etc.) might not work anymore.

{% hint style="danger" %}
**SUPPORT POLICY ON CHILD THEMES**

While child themes are a great way to add custom changes to the main theme, they are generally used to customize the core code of the parent theme. Because of this, please be aware that **customizations of this nature fall outside our scope of support**, and we will be unable to assist you with issues that may arise from it.
{% endhint %}
