Magento - transfer theme to another site

Magento - transfer theme to another site

August 24, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - transfer theme to another site

Transferring Magento Themes Between Sites: A Comprehensive Guide

Building an e-commerce site for a customer using Magento is a rewarding experience, but when it comes to transferring your carefully crafted theme to a new site, things can get tricky. In this post, we’ll guide you through the process of migrating your Magento theme and ensure that all extensions play nicely together.

Understanding Theme Structure in Magento

Before we dive into the steps, let’s quickly review how themes are structured in Magento:

  • app/design: Contains the XML layout files (app/design/frontend/default/your_package/layout) and template files (app/design/frontend/default/your_package/template).
  • skin: Holds your CSS stylesheets (skin/frontend/default/your_package/css), images (skin/frontend/default/your_package/images), and JavaScript files.

Step-by-Step: Transferring Your Theme

  1. Backup everything: Before you start, make sure to backup both your existing Magento site and the new installation. You can use tools like phpMyAdmin for database backups.

  2. Copy ‘app’ and ‘skin’ folders:

    • In your existing theme folder (e.g., app/design/frontend/default/mytheme), create a zip archive of the entire folder structure.
    • Unzip this archive into the corresponding location on your new Magento installation: app/design/frontend/default.
    # From old site:
    zip -r mytheme.zip app/design/frontend/default/mytheme
    
    # To new site:
    unzip mytheme.zip -d app/design/frontend/default/
    
  3. Update the theme package and theme name:

    • Open app/etc/modules/Company_MyTheme.xml.
    • Update the <code> value with your desired theme code (e.g., <code>your_new_package_your_new_theme</code>).
  4. Clear cache and set permissions:

    • Clear all caches: rm -rf var/cache/* and rm -rf var/session/
    • Set permissions to 644 for var/ and its subfolders.
  5. Activate your theme: In the Magento admin, go to System > Configuration > Design. Select your store view and set the “Package Name” and “Theme Name” to match your new theme code (e.g., your_new_package_your_new_theme).

Installing Extensions: Before or After Theme Transfer?

The order in which you install extensions doesn’t matter for the core functionality of your theme. However, there are a few things to consider:

  • Template Overrides: Some extensions may override layout or template files that your theme uses. To avoid conflicts, it’s best to install and configure these first.

  • Dependency Resolution: Magento automatically resolves dependencies between extensions and your theme when you run php bin/magento setup:upgrade and bin/magento setup:static-content:deploy. This ensures everything is in sync.

Conclusion

Transferring a Magento theme between sites requires careful attention to detail, but with the right steps, it’s well within reach. By following this guide, you’ll successfully migrate your theme while keeping all extensions intact.

Remember, always backup before making changes and thoroughly test on your staging environment before pushing live. If you’re still having trouble or need professional assistance, don’t hesitate to reach out to our Magento development team.

Happy migrating!

Database Extensions Themes Admin

Our network