Magento Marketplace User Guide
Completing the Extension Profile

The product profile shows the current status of the extension or theme, and provides the content that appears in the Magento Marketplace listing. The following instructions walk you through each field of the form that must be complete before the product can be submitted for Marketing Review.

  • Read-Only Information




    The name was entered when the extension was submitted.

    Version Number

    The Version Number that was entered when the extension was submitted.

    Review Status Indicator

    Indicates the current position of the extension in the submission workflow.

    In Technical Review

    Requires Developer Action

    Ready for Marketing Review

    Product ID

    The Product ID is generated when the extension is submitted.

    Supported Platform

    The platform(s) supported by this extension.


    Indicates if the extension is standalone or an integration with other products or services.

    Package Details


    Uploads a new version of the package. For example, if you want to change the extension title, you must re-upload the package. Uploading a package restarts the technical review process, and might take up to five days.

    Package Name

    The name of the zip file that was uploaded when the package was submitted.

    Last Uploaded

    The date and time the package was last submitted.

    Review Status

    Indicates the status of the package in the review workflow, with links to the results, if available.

    View the Technical Report

    Displays the results of the Technical Review.


    Lists any shared packages that are used by the extension.

  • Field Descriptions



    Short Description

    A couple of sentences in English that provides a quick summary of what the extension can do for merchants. The short description appears at the top of the page next to the title, and should not include the extension name. Maximum characters: 255.

    Long Description

    Provides the detailed description that appears on the Overview tab of the extension listing. Begin with an introductory paragraph that provides an overview of the extension, followed by more detailed information.

    Use the default body style for the opening paragraph, and do not begin with a heading. Use boldface text only for pricing information. Any additional fees or subscription pricing — including fees charged by a third-party company for integrated services — must be included in the opening paragraph as bold.

    Use bullets to list features, and make sure to convert all URLs to functioning hyperlinks.

    You can use simple HTML tags to format the text. To learn more, see: Text Format Guidelines. Maximum characters: 10,000.

    Product Images

    You can upload up to fifteen images to the extension profile. Either drag each image to the box, or browse to the files and upload them from the directory. The first image uploaded becomes the main image for the profile and is featured in extensions listings.

    Links to YouTube Videos

    (Optional) Links to up to two YouTube videos from your extension profile.

    Version Information


    Identifies up to three categories for the extension listing.

    Magento Edition & Version

    Identifies each edition and version of Magento that is supported by the extension.

    Supported  Browsers

    Identities the versions of each browser that is supported by the extension. Tap the icon for each browser, and mark the checkbox of each supported version.

    Internet Explorer / Edge

    Mozilla Firefox

    Google Chrome




    (Optional, depending on license) Uploads a separate PDF for each of the following:

    Installation Guide

    Installation instructions are required if the extension is distributed under the GNU Lesser General Public License 3.0.

    User Guide

    A user guide is presented in the order a user might approach the subject, and typically includes step-by-step instructions and screenshots.

    Reference Guide

    A reference guide typically follows the structure of the product, and is designed to help you find specific information.

    Make sure to reduce the size of the PDF before uploading it to the profile. Maximum file size for each PDF: 5 MB

    License Type

    Identifies the license type that defines the terms of use. To learn more, see the Open Source Initiative’s Licenses by Name. Options:

    Open Software License 3.0

    The Open Software License 3.0 (OSL-3.0) is a worldwide, royalty-free, non-exclusive license that allows sublicensing and derivative work, provided that they are distributed under the same license.

    Mozilla Public License 1.1

    The Mozilla Public License 1.1 (MPL-1.1) is an open source license that includes explicit patent rights and allows extensions of the code to be licensed in non-open ways. There is no requirement for a derivative work to be distributed under the same license.

    MIT License

    The Massachusetts Institute of Technology License (MIT) allows for the reuse, modification, distribution, sublicensing, and sale of proprietary software, provided that all copies include the MIT license and copyright notice.

    GNU Lesser General Public License 3.0

    The GNU Lesser General Public License 3.0 (LGPL-3.0) is widely used and based on the GNU open source license. LGPL03.0 is somewhat less restrictive than the standard GLP-3.0, and also requires that you provide installation instructions. To learn more, see: Frequently Asked Questions about GNU Licenses.

    GNU General Public License 3.0

    The GNU General Public License 3.0 (GLP-3.0) is widely used and based on the GNU open source license, and allows for the redistribution of software received from the copyright holder within the provisions outlined in the agreement. Any improved version of the software must be made available for free. To learn more, see: Frequently Asked Questions about GNU Licenses.

    BSD 2-Clause License

    The Berkeley Software Distribution 2-Clause License requires the copyright notice to appear in all source code, but imposes minimal restrictions on the redistribution of open source software. The 2-clause license was derived from the original 4-clause BSD license which requires a notice to appear in all advertising and prohibits the use of the contributor names in endorsements without prior written permission.

    Apache License 2.0

    The Apache License 2.0 describes the terms of use, reproduction, and distribution of third-party software products that include portions of Apache software. It requires clear attribution to The Apache Software Foundation for any distributions that include Apache software.

    Academic Free License 3.0

    The Academic Free License 3.0 (AFL) is an open source license that permits the free distribution and reuse of proprietary software and derivative works, provided that the source code is made available.


    Describes the extension’s current stage of development. Only extensions at the beta or stable stage can be uploaded to Magento Marketplace. Options:


    Internal testing is complete, and the extension is released to the public to help identify any outstanding issues.


    Any major issues found during the beta release stage have been resolved, and the extension is ready for market.

    Additional Details

    Mark the checkbox of each applicable item:

    Released with Setup Scripts

    Included Service Contracts

    Included External Service Contracts

    Custom Implementation UI

    Support Web API

    Included not @api-annotated Methods

    Support Test Coverage

    Supports Responsive Design

    Release Notes

    Describes the current release, including any changes from the previous release and known issues. Maximum characters: 10,000 including spaces.

    Extension and Service Pricing

    Extension Price

    Determines the price that is charged for each supported edition of the extension in U. S. currency. The price must reflect fair market value, with a minimum of $25. If the extension is also available for sale on your site, the prices must be the same.

    Installation Details and Price

    (Optional) Determines the price that is charged for installation services of Community or Enterprise Edition products, if applicable.

    Support Details and Price

    (Optional) Determines the price that is charged on a monthly basis for ongoing Community or Enterprise Edition support. You can define up to three tiers for support pricing.