App Builder app
The following screenshots explain the creation and submission of an App Builder listing and version for Adobe review.
Looking for help building your App Builder app? See the App Builder Public Distribution page for more details.
Creating a Listing
A new listing can be created from the home page or the “Your listings” page. Clicking on ‘Create a new listing’ lands the developer on the modal overlay where they must choose the type of listing they want to create.
Some types of listings have prerequisites that developers need to fulfil before they can create the listing. For example, in order to create an App Builder application or a software integration listing, a developer either needs to belong to an Enterprise organization because they have purchased Experience Cloud products or they will need to first register to the Technology Partner Program portal.
Once the listing type has been chosen, another modal will ask the developer to choose the project they want to be associated with the listing. The developer can either choose an existing project, or create the listing in a new project.
Upon successful creation of the listing, the developer will be routed to the "Listing Overview" page. This page provides a high-level overview of the listing, such as its status, listing type, last modified date, and next steps.
The developer can navigate to the “Listing details” page to add listing-level metadata details that help users discover their listing in the marketplace once it’s published.
This is the landing page to create a submission. Note the following items for App Builder listings:
- The navigation panel on the left confirms that this is the Listing Details screen.
- The requestor's role and organization name are listed in the upper right-hand corner. If any profile details need to be edited, click the "Edit Public Profile" tab.
- The menu at the top of the screen indicates the listing status, the platform, the last modified date, and the APP ID. The listing details for the app are ready to be added now.
Listing Details
Submit the App Builder new listing metadata in multiple tabs: General, Media, Categories, and Payment. All mandatory fields are marked with an asterisk.
Listing details and a new version must be submitted together for the first listing. After publishing, the developer can submit an update to the listing details or a new version independently from each other.
New Submission - Once the app has been built, tested, and packaged (using App Builder in the Adobe Developer Distribution portal), create the listing for the Marketplace. Executing the command "Distribute" will take you the Developer Console to create a listing for the app.
The General tab has the application’s public name, a short description (subtitle), a long description, URL for documentation, support information (email and URL), URL for Privacy policy, and URL for Terms of Service. Be sure to save a draft if you navigate away from the page.
The Media tab requires three different icon sizes for each integration. To describe the integration, up to ten screenshots and up to ten video links can be used. A caption can be added for each image and video.
The Categories tab has categories (such as Country and Industry) and custom tags that developers can add. These categories and tags help marketplace customers discover and filter/sort App Builder apps published on the marketplace.
The “Marketplaces” checkbox lets the developers choose if they want to publish their application on the Commerce marketplace, along-with the Exchange marketplace. When choosing to publish on Commerce marketplace, additional categories need to be completed.
The Payment tab is for entering purchase options to the listing. For now, the only option that App Builder listings can offer is 'Free' as the purchase method. In the future, App Builder listings will also have the paid purchase methods of subscription and one-time payment (Perpetual).
Version Details
App Builder requires a package to be uploaded and validated before the developer can submit the listing for Adobe’s review. The developer will see the option to ‘Add new version’ in the left navigation bar. Clicking on ‘Add new version’ creates a new version and takes the developer to the “Version Details” page.
Once the app has been built, tested, and packaged (using App Builder in the Adobe Developer Distribution portal), the package can be uploaded by dragging and dropping the package on the “Version Details” tag or by clicking “Select a file”. Upon successful upload of a file, scans and validations are performed to confirm that all the details of the package are in the required format, and the files are the right size and type.
The developer can keep adding more information related to the version (such as optional products that their app supports and release notes) while the validations are performed. The “Package download” checkbox lets developers opt to allow users to download the package once they have acquired it from the marketplace.
When all the mandatory listing and version level details have been added, and the version package has passed the validations, the Preview and submit button will be enabled. Clicking the button will open the submission modal. The modal also gives the developer the option to preview the listing or view their public profile.
For an initial listing, the developer can’t choose what they are submitting as a new listing and its first version are always submitted together. The developer must provide a note to Adobe reviewers and mark the checkbox for Adobe brand guidelines in order for the Submit listing button to be enabled.
“Delay publishing” allows the developer to choose whether they want to publish the app immediately on approval by Adobe, or at a later date.
Upon successful submission of the listing, the developer is taken to the “Listing Overview” page, where a success message confirms the submission. The status of the Listing changes from draft to “In review."
Reviewing A Submission
When an application has been submitted for review, an Adobe administrator will review the application details. If all the information is complete and the requirements are met, the reviewer will approve the submission. The status of the submission will show a green ‘Approved’ or ‘Published’, depending on what the developer chose as the publishing time preference.
The developer is notified by email when the listing is submitted, and when it has been approved and published on the marketplace.
An existing listing can be patched by adding a second or subsequent version. In such cases, the version-level metadata from the earlier version is copied over to the new draft version for the developer to update as they see fit.
Listing details can be edited on a published listing. Metadata edits are highlighted by a yellow outline. The status has an edit suffix.
Edits can be submitted for review and will take effect immediately upon approval. Note the edit suffix on the submission modal and the fact that “Delayed publishing” is disabled for metadata changes to a published listing.
