Submit for technical review overview
All products submitted to Commerce Marketplace must pass the technical review as part of the submission workflow. For all product types except apps, the technical review process is automated. For apps, this process is manual.
Technical review helps to improve the quality of products on Commerce Marketplace by checking for indications of plagiarism, malware, and adherence to Adobe coding standards. Developers whose submissions do not pass technical review receive a report of the results. After the issues are resolved, you are welcome to resubmit the product. Submissions must pass technical review to receive a listing on Commerce Marketplace.
When your submission form is complete, you can submit your product for technical review. During the process, we review the code according to technical guidelines, install and use the product according to your documentation, and verify specifics from your submission form. You can track the status and progress of your submission through your Marketplace account.
The following instructions show how to submit an extension for technical review. The process is essentially the same for apps, themes and shared packages.
Important - Shared Packages: If your extension uses shared packages (or components), the packages must be ready and associated with your submission. You will not be able to submit your extension to technical review until the shared packages are available in your account.
Prepare for technical review
Before submitting a product for marketing review, conduct your own internal review of the content to make sure that it is ready for publication.
- Review the technical guidelines to ensure that your submission meets Commerce Marketplace and Magento development requirements.
- For theme extensions, verify all image, css, and code assets correctly load on the storefront. For feature / service extensions, make sure data and options follow coding standards, logging, etc.
- All extensions and apps must be secure, without viruses, malware, or vulnerabilities.
- Fully test your product, including installation, dependencies, shared packages, configuration, and usage.
Terms and conditions
All products and services are subject to the same Commerce Marketplace terms and conditions that are communicated to developers upon submission, and to merchants upon the purchase of any product or service. A separate licensing agreement is not required. However, you can include additional terms and conditions as follows:
- Create a workflow that requires the merchant to accept the terms and conditions when the extension or app is installed.
- Place a link to the separate agreement in the extension or app description.
Step 1: Enter technical submission details
Log into the Marketplace Developer Portal, and then click Apps, Extensions, Themes, or Shared Packages.
Click the listing name you want to submit.
The Technical Submission page loads. You can save progress and reopen this page to submit when you are ready.
Click Attach Package to upload the listing code package.
For complete package guidelines, see Package a component.
For Magento Version Compatibility, select the supported version number and compatibility for the extension.
The listed options include all minor versions Adobe Commerce supports at time of submission.
Select the Licensing options.
This option requires the user to agree to a license in addition to the terms and conditions. You have two options:
Choose a License Type - Select a license type provided from the drop-down menu.
Enter a Custom License - Enter the name and URL location for your custom license, available from a public website.
Add Documentation and Resources for your extension.
Commerce Marketplace tests and reviews documentation during the technical review. You can add additional documentation during the marketing review.
You must include at least one of the following, in PDF format (less than 5MB):
- Attach User Guide - Documentation describing how to configure and use your listing's features in the Admin and any other screens.
- Attach Reference Manual - Documentation detailing fields, screens, and workflows for the added features, screens, and fields in the Admin.
- Attach Installation Guide - Documentation instructing how to install and configure the listing on your instance.
Follow the same steps to upload a reference manual or installation guide.
If other components are used by a Commerce extension, select the relevant Shared Package.
Important: Before a shared package can be linked to an extension, it must be submitted for review and must receive the status Ready to Use.
Enter Release Notes for your extension.
This preliminary draft can be formatted with simple HTML and can include text, numbers, symbols, and spaces.
When complete, submit the product or save to continue progress later. To enter the queue, you must click Submit.
Step 2: Submit the product for technical review
When the required fields are complete, click Submit.
In the Confirm Your Technical Submission box, click Cancel to go back to the submission details, or click Confirm to submit the extension.
It might take a few minutes for your package to upload. You will receive email confirmation when the package is submitted for technical review. You will also be notified when the review is complete.
After submission
If you have not submitted the marketing review, complete those steps to submission.
Watch your email for feedback and updates for the technical review.
Check the Test Reports posted for your submission through the Developer portal.
If issues, errors, or changes are required, you will receive an email failure notification. The submission will be in a failed state. When those issues are resolved, re-submit the package for review.
Field descriptions
Field | Description |
---|---|
Adobe Commerce Version Compatibility | Specifies each version of Commerce the listing supports. |
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: Custom License - To use a custom license, enter the Name of the license and the License URL, where customers can read the terms of use. 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. 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. 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 four-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. 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. 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. LGPL-3.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. MIT License - The Massachusetts Institute of Technology License (MIT) allows for the reuse, modification, distribution, sub-licensing, and sale of proprietary software, provided that all copies include the MIT license and copyright notice. 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. Open Software License 3.0 - The Open Software License 3.0 (OSL-3.0) is a worldwide, royalty-free, non-exclusive license that allows sub-licensing and derivative work, provided that they are distributed under the same license. |
Documents | Upload your customer-facing documentation in PDF format. The user guide is required, and you can optionally include a reference manual and installation guide. Maximum file size: 5 MB File type: PDF User Guide - Your extension or app must include one user guide. Reference Manual - (Optional) Installation Guide - (Optional) Note: Although the installation guide is optional, it might be required by some license types. |
Release Notes | The preliminary Release Notes text can include simple HTML, without CSS. Maximum characters: 10,000 |
If applicable, identifies each shared package that is required by this extension. |