May 152018

How To Install Or Upgrade Suffusion Theme shows you how to manually install the latest version of suffusion theme by following a few steps and more.

Last Updated: January 9, 2020

Latest News: Updated the documentation.

Most people nowadays know how to install a theme in WordPress. In this documentation you will learn how to upload and install Suffusion theme in your site, upload the zip folder from your computer to the server and unzip the folder and replace the files in the server or upload only the necessary files to update Suffusion theme.

The following list of steps walks you through the steps needed to achieve this. There are 3 methods mentioned below to install Suffusion theme, choose the steps needed for your method.

List of step to carry out:

  • Download the latest version from github. (Applies to all methods)
  • Create a backup of your site just in case something goes wrong. (Applies to all methods)
  • Install Suffusion theme for the first time.
  • Install a second theme and put your site in maintenance mode.
  • Delete and/ or replace the current version from your site.
  • Upload the theme from your computer or laptop and unzip the content.
  • Copy and paste to replace the existing files.
  • Activate Suffusion parent theme or the child theme if you are using one.
  • Import the settings if you exported them.
  • Check to make sure the theme is working correctly.

Suffusion Theme / Child Theme Tutorials:

How To Install Or Upgrade Suffusion Theme

The best and safest method to install or upgrade Suffusion theme is illustrated in the following steps. Please make sure you follow each step correctly.

If you don’t have a security plugin in place, I highly recommend the following security plugin All In One WP Security And Firewall. This plugin has a feature that allows you to put your site in maintenance mode. Click the following link all-in-one-wp-security-and-firewall-maintenance to learn more.

Method 1: First Time Installing The Theme

These steps are meant for those who are installing Suffusion theme for the first time.

Step 1 ) You should put your site in Maintenance mode first before you begin.

Step 2 ) Download the latest version from the following URL

Step 3 ) Create a back up of your site, this is just for precaution just in case something goes wrong. Like they say, it’s better to be safe than sorry.

Step 4 ) Install suffusion theme like you normally install a theme.

Note: The following documentation how-to-install-wordpress-theme.php shows you how to install a theme.

Method 2: Updating Current Theme Installation

These steps are meant for those who have an older version of Suffusion and want to replace the old theme with the updated version.

Step 5 ) First you need to export suffusion settings. You can read more about it from the following documentation suffusion-theme-options-introduction-export-import.

Note: If you have a child theme installed for Suffusion, you don’t have to export the settings.

Step 6 ) You need to install a second theme. This is important because you will be putting your site in maintenance mode. WordPress has some great default themes, so I suggest that you install one of WordPress default themes like Twenty Nineteen. (Remember: This should only take a few minutes if everything goes well.) Activate the new theme you installed and delete suffusion theme.

Step 7 ) Upload the latest version you downloaded in Step 2 ) above. Activate the latest version of Suffusion and import suffusion settings if you exported the settings in Step 4 ) above.

Note: If you have a child theme for Suffusion, you need to activate the child theme instead.

Step 8 ) Check to make sure all your settings are correct and your site looks the same as before.

Step 9 ) If everything went smooth and there are no issues, you should have your site running the latest version of Suffusion.

Method 3: Updating The Theme Manually (By FTP or Other)

These steps are meant for those who have access to their server via FTP or file manager and know what they are doing. (Highly recommended for experts only).

Step 10 ) Use File Manager in cPanel or FileZilla. (Note: Use the plugin WP File Manager, if you are not comfortable using file manager or cpanel.)

  • Upload the zipped folder you downloaded from Step 2 ) above.
  • Unzip the folder and copy and paste the content into the suffusion folder that already exist in your server. This will override all Suffusion files and folders with the updated version.
  • Import suffusion settings if you exported the settings in Step 4 ) above.
  • Visit your site to make sure it looks the same as before. Also make sure everything looks and works okay in Suffusion admin panel.

Note: Alternative you can simply upload the files mentioned below under Files Locations.

Step 10-a ) If you choose to upload only the files needed as mentioned below and use FileZilla, the process is similar.

  • Unzip the content in your laptop or computer.
  • Locate the files mentioned below.
  • Upload the files to the same location in Suffusion.
  • Check your site and Suffusion admin panel.

Suffusion Theme Installed Location

  • = suffusion and child-theme

Github Changelog

If you downloaded version 4.5.6 from github above and this is the first time you upgrade the theme, then you only need to upload the files mentioned below. This can save you having to upload the whole theme to your server.

The following is a list of the changes made to Suffusion by the developers in the versions mentioned below. Please refer to the corresponding File Location for each updated version.


Version 4.5.6 – 21 May 2016

Fixed Warning: “continue” targeting switch is equivalent to “break”. in media.php.


Version 4.5.4 – 4.5.5 – Colin fixes

Fixed my mistakes in versioning the theme and returning back to http instead https in site-footer.php


Version 4.5.3 – 06 Mar 2018 – Opa Jaap fixes

Fixed PHP notices: “Trying to get property ‘ID’ of non-object” in actions.php and “Undefined index: HTTP_USER_AGENT” in framework.php.


Version 4.5.2 – 23 Feb 2018 – Opa Jaap bug fixes

Solved bug related to not always saving the changes from Custom Styles when is settled to save those changes in a file.


Version 4.5.1 – 12 Feb 2018 – Drake version

Minor changes to the code for preventing the PHP warnings on servers with PHP 7+


Files Locations To Upload Via FTP

This list the location of the files in version 4.5.6 which need to be uploaded via FTP to your server. The files need to be uploaded in the same path as illustrated in the location below.

Note: Only upload the files you need. For example: If your theme version is 4.5.5, then you only need to upload the file changed in version 4.5.6. If your theme version is 4.5.1, then you need to upload all the files from version 4.5.2 upwards.

File Location 1 )

  • ChangeLog = Version 4.5.6
  • style.css = Version 4.5.6

File Location 2 )

  • suffusion-options-page.php = Version 4.5.2

File Location 3 )

  • site-footer.php = Version 4.5.4 – 4.5.5

File Location 4 )

  • actions.php = Version 4.5.3
  • framework.php = Version 4.5.3
  • media.php = Version 4.5.6
  • template.php = Version 4.5.2


If you have any questions please leave a comment. I will be updating this tutorial from time to time.

More suffusion tutorials:

I have been working in IT since 1999 and I enjoy the challenges it brings me. I love developing websites with WordPress. I spend a lot of time helping out in forums. I have been writing tutorials since 2011. Now I am learning how to manage my own VPS "Virtual Private Server.

  8 Responses to “How To Install Or Upgrade Suffusion Theme”

  1. Hi!

    Are all the steps above really necessary? An installation of Suffusion seems quire simple if you look at this instruction…

    Is it possibly a different process if it’s a matter of upgrading?

    • Hi, yes the instructions are simple but they are meant for those who are installing Suffusion for the first time. My instructions cover all aspects of the installation process. For example: You might have an older version already running and you wish to update. You might not want to touch your customize version and only update the files changed in the latest version. It is also important to export your settings if you are updating your older version with the latest version. I think you get what I mean.

      If you need any more help with your questions please let me know.

      Kind regards

  2. OK, so there is no simple in-place upgrade for this theme then?

    • Hi,

      Most users nowadays use a child theme. This makes it much easier to upgrade the parent theme without affecting the customizes changes made in the child theme. If you follow my instructions in this post you should be okay.

      Kind regards

  3. The only custom settings that I have are at Back-end/Custom Includes. Would those settings actually be affected (or wiped) by an upgrade?

    • No, those settings will not be lost. However as a rule of thumb it is always important to create a backup just in case you run into issues. As they say, it is better to be safe than sorry.

      Kind regards

  4. Got it! But theoretically the simple method would work in my case (download, unzip, upload/replace and activate), right?
    After all, there is a server side backup available… Just in case.

 Leave a Reply

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>