Installing the osCommerce Theme Switcher

osCommerce by default only has one theme available. Before you can Change the theme in osCommerce you will need the Theme Switcher module. To switch themes, there is quite a few steps. You will need the Theme Switcher module so the themes can be changed within the osCommerce Administrative Dashboard. First the Theme switcher module needs to be installed, then the jQuery needs to be fixed, and lastly a theme can be uploaded. This article will explain how to install the Theme Switcher module.

Before you can install the module, you will need to Download the plugin at the following link:

Theme Switcher

Once you have the theme switcher files, you can install the module. Follow the steps below to install the Theme Switcher module in osCommerce.

Steps to install the Theme Switcher module

  1. Login into your cPanel.
  2. Go to the File Manager Select the directory for your osCommerce installation and click Go.
  3. Extract the .zip file with the Theme Switcher files in it and upload the following files to each specified location.


    Find the following file in the catalogincludeslanguagesenglishmodules/header_tags folder of the .zip file:


    Upload the ht_theme_switcher.php file to the following directory on your server:



    Find the following file in the catalogincludes directory of the .zip file:


    Upload the file to the following directory on your server:



    Find the following file in the catalogincludesmodulesheader_tags directory of the .zip file:


    Upload the file to the following directory on your server:


  4. Select teh Header Tags osCommerce 2.3.3

    Log into your osCommerce administrative Dashboard.

    Navigate to Modules > Header Tags on the left navigation menu.

  5. Install teh theme switcher module osCommerce 2.3.3

    Click the Install Module button at the top right.

  6. Click the module osCommerce 2.3.3

    Click the Theme Switcher title in the Modules list.

    Click Install Module.

  7. Installed switcher osCommerce 2.3.3

    The Module will install with red errors like the snapshot to the right.

    Don’t worry about this now. The next tutorial will explain how to update your jQuery files to the newest version.

    View of interface osCommerce 2.3.3

    Click the Edit button towards the top. You will see the theme switcher interface. Now we need to fix the version of jQuery and upload a new theme.

9 thoughts on “Installing the osCommerce Theme Switcher

  1. Dear John,

    Much Thanks for the reply. As I said earlier, I use OSCommerce version – v2.3.4. I tried the above listed steps, all from scratch thrice, however the problem persisted without the theme_switcher not showing up at all in the header tags. But, in my last attempt, the module showed, but when I tried installation, I got the following error.

    Fatal error: Cannot redeclare class ht_theme_switcher in /home/u196887925/public_html/cart/includes/modules/header_tags/ht_theme_switcher.php on line 14″

    Still, the theme switcher doesnt show up.

    Any help from your side will be greatly appreciated.


    Much thanks again.

    1. Hello Prem,

      Thank you for contacting us. I spent a long time with this on a clean installation of “v2.3.4” and am unable to replicate your error. Make sure you are following the steps exactly, as far as folder locations. Step 7 was not even required in my test.

      If you are still having problems, this leads me to believe that an addon, or change that was made after initial installation is causing the problem. You may want to try disabling any modules or 3rd party addons, and testing again.

      Turning on error reporting in PHP may help get a more detailed clue into what is happening.

      Thank you,

  2. Dear John,

    I too face the same issues as Gentiana. The theme switcher doesnt show in the header tags.

    I tried browser clearing as mentioned, but it didnt help.

    OSCommerce version – v2.3.4.

    My website is under development by the way.

    1. Hello Prem,

      What is the current version of osCommerce you are using? Are you receiving any error messages when following the instructions? Were you able to seemingly complete the instructions above?

      Kindest Regards,
      Scott M

    1. Hello Gentiana,

      Thank you for your question. We are happy to help, but will need some additional information.

      Have you tried clearing your browser cache yet?

      What version of OsCommerce are you running?

      Can you provide a link to the website?

      Thank you,

Was this article helpful? Join the conversation!