How to package magento extension

How to package magento extension

October 1, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to package magento extension

Packaging Magento Extensions: A Step-by-Step Guide

Hello developers! Today, I’m going to walk you through the process of packaging your own Magento extension. Whether it’s a theme like wireframe or a custom module, this guide will help you create a zip file that can be easily installed into any Magento installation.

Understanding the Magento Extension Structure

Before we dive into packaging, let’s quickly review the structure of a typical Magento extension:

./app/code/local/Your_Company/Your_Extension/

The local folder is where all custom extensions reside. Inside this, you have your company name (Your_Company) and then the specific module or theme (Your_Extension).

Packaging Your Custom Theme

For our wireframe theme example, here’s how to package it correctly:

  1. Place Your Theme Files

Ensure your theme files are located in the correct folders:

./app/design/frontend/your_package/your_theme/
./skin/frontend/your_package/your_theme/

Replace your_package and your_theme with your actual package and theme names.

  1. Open Magento Connect Manager

Log into your Magento back-end and navigate to System > Magento Connect > Magento Connect Manager.

  1. Configure the Package
  • In the “Package Name” field, enter a name for your extension (e.g., Wireframe Theme).
  • Under “Target Path”, specify ./app/code/local/.
  • For “Type”, select Recursive Directory.
  1. Choose Your Theme Directory

In the “Directories to be packed” section:

  • Click on the “Add Directory” button.
  • Enter /app/design/frontend/your_package/your_theme/ and click OK.
  1. Package Your Extension

Click on the “Pack” button at the bottom of the page. Magento will create a zip file in var/connect/ with your extension’s name.

Extracting the Packaged File: What to Expect

When you extract this zip file, you should see two main folders:

  • /app/code/local/Your_Company/Your_Extension/app/: Contains all the app files from your theme.
  • /app/code/local/Your_Company/Your_Extension/skin/: Contains all the skin files.

If you only see an XML file, it means Magento didn’t correctly identify the directories to include in your package. Review and double-check your directory paths and selections.

Troubleshooting Tips

  1. Check Your Theme Directories: Ensure that your theme’s app and skin folders are located exactly where they should be (as specified above).

  2. Verify Directory Selection: In the Connect Manager, make sure you’re selecting the correct directories for packaging.

  3. File Permissions: Sometimes, file permission issues can prevent Magento from reading directories correctly. Double-check that your files have the appropriate read/write permissions.

Conclusion: Packaging Your Way to Success

Remember, proper packaging is key when distributing custom extensions or themes for Magento. It ensures a seamless installation experience for your users and maintains the integrity of your code.

If you’re looking to learn more about Magento development best practices, check out our Laravel Company blog. We cover everything from theme design to module creation.

Happy coding!

Extensions Themes Configuration

Our network