From 609359066c7d05c66b917189ceb3cd9903b6518d Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Wed, 16 Jul 2025 08:59:32 +0200 Subject: [PATCH 01/15] Changed structure --- content/en/docs/marketplace/genai/_index.md | 2 +- content/en/docs/marketplace/partner-solutions/_index.md | 2 +- .../docs/marketplace/platform-supported-content/_index.md | 2 +- .../{create-content => }/upload-content/_index.md | 6 ++---- .../upload-content/governance-process.md | 0 .../{create-content => }/upload-content/oss-compliance.md | 0 content/en/docs/marketplace/use-content/_index.md | 2 +- 7 files changed, 6 insertions(+), 8 deletions(-) rename content/en/docs/marketplace/{create-content => }/upload-content/_index.md (98%) rename content/en/docs/marketplace/{create-content => }/upload-content/governance-process.md (100%) rename content/en/docs/marketplace/{create-content => }/upload-content/oss-compliance.md (100%) diff --git a/content/en/docs/marketplace/genai/_index.md b/content/en/docs/marketplace/genai/_index.md index 23f54288c3a..48e108a5316 100644 --- a/content/en/docs/marketplace/genai/_index.md +++ b/content/en/docs/marketplace/genai/_index.md @@ -3,7 +3,7 @@ title: "Enrich Your Mendix App with GenAI Capabilities" url: /appstore/modules/genai/ linktitle: "GenAI Capabilities of Mendix" description: "Describes the general properties and common concepts of generative AI in the context of developing Mendix applications and illustrates the preferred way of leveraging platform-supported connectors in applications following the GenAI Commons patterns." -weight: 5 +weight: 6 --- ## Introduction {#introduction} diff --git a/content/en/docs/marketplace/partner-solutions/_index.md b/content/en/docs/marketplace/partner-solutions/_index.md index bd94a9aff11..1a911a4be7d 100644 --- a/content/en/docs/marketplace/partner-solutions/_index.md +++ b/content/en/docs/marketplace/partner-solutions/_index.md @@ -2,7 +2,7 @@ title: "Partner Solutions" url: /appstore/partner-solutions/ description: "Presents details on the partner solutions available in the Mendix Marketplace." -weight: 6 +weight: 7 no_list: false description_list: true --- diff --git a/content/en/docs/marketplace/platform-supported-content/_index.md b/content/en/docs/marketplace/platform-supported-content/_index.md index 8cd6eb1473c..dccc24e0d57 100644 --- a/content/en/docs/marketplace/platform-supported-content/_index.md +++ b/content/en/docs/marketplace/platform-supported-content/_index.md @@ -1,7 +1,7 @@ --- title: "Platform-Supported Content" url: /appstore/platform-supported-content/ -weight: 4 +weight: 5 description: "" no_list: false --- diff --git a/content/en/docs/marketplace/create-content/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md similarity index 98% rename from content/en/docs/marketplace/create-content/upload-content/_index.md rename to content/en/docs/marketplace/upload-content/_index.md index 2ac1ece64da..3a92d24416a 100644 --- a/content/en/docs/marketplace/create-content/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -1,7 +1,7 @@ --- title: "Uploading to the Marketplace" url: /appstore/submit-content/ -weight: 6 +weight: 3 description_list: true description: "Describes how to submit content to the Mendix Marketplace content." tags: ["marketplace", "public marketplace", "private marketplace", widget", "module"] @@ -18,9 +18,7 @@ The Mendix Marketplace is driven by contributions from community members who sha ## Prerequisites -Before starting this how-to, make sure you have completed the following prerequisites: - -* Familiarize yourself with [Marketplace Overview](/appstore/overview/) and [Using Marketplace Content](/appstore/use-content/). +Before diving in, make sure you have read [Marketplace Overview](/appstore/overview/) and [Using Marketplace Content](/appstore/use-content/). ## Adding New Marketplace Content {#adding} diff --git a/content/en/docs/marketplace/create-content/upload-content/governance-process.md b/content/en/docs/marketplace/upload-content/governance-process.md similarity index 100% rename from content/en/docs/marketplace/create-content/upload-content/governance-process.md rename to content/en/docs/marketplace/upload-content/governance-process.md diff --git a/content/en/docs/marketplace/create-content/upload-content/oss-compliance.md b/content/en/docs/marketplace/upload-content/oss-compliance.md similarity index 100% rename from content/en/docs/marketplace/create-content/upload-content/oss-compliance.md rename to content/en/docs/marketplace/upload-content/oss-compliance.md diff --git a/content/en/docs/marketplace/use-content/_index.md b/content/en/docs/marketplace/use-content/_index.md index 2cc8c6ddf26..7daea156bd3 100644 --- a/content/en/docs/marketplace/use-content/_index.md +++ b/content/en/docs/marketplace/use-content/_index.md @@ -1,7 +1,7 @@ --- title: "Using Marketplace Content" url: /appstore/use-content/ -weight: 3 +weight: 4 description: "Covers the basics of how to access the Marketplace from Studio Pro and provides examples of how to add a widget and module to your app." no_list: false aliases: From 64f114b5aef22c2814290ead8341fcde83ed0e4e Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Fri, 18 Jul 2025 16:31:18 +0200 Subject: [PATCH 02/15] Updated info per design - provisional --- .../docs/marketplace/upload-content/_index.md | 189 +++++++++--------- .../upload-content/governance-process.md | 1 + .../marketplace/upload-content/licenses.md | 29 +++ .../upload-content/oss-compliance.md | 1 + 4 files changed, 121 insertions(+), 99 deletions(-) create mode 100644 content/en/docs/marketplace/upload-content/licenses.md diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 3a92d24416a..c51f70b6316 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -1,5 +1,5 @@ --- -title: "Uploading to the Marketplace" +title: "Uploading Content to the Marketplace" url: /appstore/submit-content/ weight: 3 description_list: true @@ -22,155 +22,146 @@ Before diving in, make sure you have read [Marketplace Overview](/appstore/overv ## Adding New Marketplace Content {#adding} -To get started, click **Add Content** in the left pane of the Marketplace home screen. Follow the steps in these sections to add content. +To get started, click **Add Content** in the left pane of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. -{{% alert color="info" %}} -On each page of the upload flow, click one of the following buttons: +Once you make sure you have everything, click **Next**, then go through the steps in the following sections to add content. +Some fields are mandatory, while others are optional — this is indicated in the user interface. -* **Save Draft** to save the details you have entered so far for the draft. You can access the draft via the [My Drafts](/appstore/home-page/#my-drafts) link in the top bar. -* **Save & Continue** to go to the next page of the upload flow. -{{% /alert %}} +On each page of the upload flow, click one of these buttons: -### General {#general} +* **Save and Exit** — Save the details you have entered so far for the draft. You can access the draft via the [My Drafts](/appstore/home-page/#my-drafts) link in the top bar. +* **Next** — Go to the next page of the upload flow. -Provide key details about your component on the **General** page. +## Uploading a Component {#general} -#### Describing Your Content +On the **Upload Component** tab, add the source file, and provide general information about your component. -Follow these steps to describe your content: +Follow these steps to add information about your component. +Some only apply to specific component types, so follow the on-screen prompts for your particular scenario. -1. Select a **Content Type** for your component. +1. Add a **Component Name**. - {{% alert color="warning" %}}You can only set the content type when creating the initial version of your content. You cannot change this setting after it is published.{{% /alert %}} +2. Select the **Component Type**. + You can only set the content type when creating the initial version of your content. You cannot change this setting after it is published. -2. Select the **Visibility** of your component: +3. Under **Select Component Source**, select one of the options for uploading the source file: - * **Public Marketplace (all Mendix users)** – Your component will be available to the entire Mendix community. - * This content must be reviewed and approved by Mendix before it is available. - * **Private Marketplace (your company only)** – Your content will receive the **Private** label, and be available only via your [Company Content](/appstore/home-page/#company-content) page. - * Selected private content of a content group can also be made available to [content group guests](/appstore/home-page/#guests) for download. - * This content is not reviewed by Mendix. - {{% alert color="warning" %}}You can only set the visibility in the initial version of your content. You cannot change this setting by updating the Marketplace component later.{{% /alert %}} - -3. Add between one and three categories in the **Category** field. A category groups together similar components or services that share common characteristics, functions, or purposes. Categories make it easier for Marketplace users to find what they are looking for. -4. Enter a **Name** for your component. -5. Enter a **Description** of your component. + * **MPK File** – Upload your source MPK. + * **GitHub Link** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. + To include the repo's *README.md* file on the component's [Documentation](#doc) tab, make sure you have selected the **Import Documentation** box. - {{% alert color="warning" %}} You can use rich text in the editor. However, using rich text at the beginning of the description is not recommended, as it will not get rendered properly. You should add a few lines of regular text before using rich text. {{% /alert %}} + If you are uploading a solution, there will be no option to select the content source. + If you are uploading an industry template, selecting a content source is optional. -#### Providing License Details {#license} +4. Select the **Studio Pro Version** on which you built the content. -Select the type of **License** you want applied to your app. +5. If you are uploading a widget, select the **Compatible with Mendix React Client** checkbox to indicate compatibility. + This checkbox is mandatory starting with Studio Pro 11. + +6. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section will automatically be set to **1.0.0**. -##### Open-Source Software Licenses +7. Enter **Release Notes** for the component in the box provided, describing what is new in that release. -{{% alert color="warning" %}} -Open-source software licenses must abide by a set of compliance rules to ensure the safety of the Mendix ecosystem. Refer to [OSS Compliance for External Developers](/appstore/submit-content/oss-compliance/) for details. -{{% /alert %}} +8. If you are uploading a solution, enter an email address in the **Contact Sales** field. This will be used by customers to reach out to you. -These are the open-source software license options available and their requirements: +## Adding General Information -| | **Notes** | **Commercial use allowed?** | **Component code needs to be in public repo?** | **License text required with copyright info in code and distribution artifact?** | **Can modify?** (Mention modifications to code) | **Can consuming apps use without making their code public?** | **Notice files should be distributed with artifact?** | **Original component source code to be distributed with consuming app?** | **Can sub-license?** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [MIT](https://opensource.org/licenses/MIT) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **BSD 2.0, 3.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **Apache 1.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **Creative Commons CC0 1.0 Universal (CC-0)** (Public Domain) | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +On the **General Information** tab, add more details about your component. -{{% alert color="info" %}} -The [GNU General Public License (GPL), version 3](https://www.gnu.org/licenses/gpl-3.0.en.html) is not available to use, as everything licensed under GNU GPL is public. -GNU GPL has a strong copyleft effect. -Modification has a strong copyleft effect. -All consuming apps should make their code public. -{{% /alert %}} +1. Upload a cover image. -##### Proprietary Licenses {#proprietary-license} +2. In the **Component Tagline**, include a short description of what your component does. -You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. +3. In the **About** field, describe the purpose and use cases of your component in detail. + You can use rich text in the editor. However, using rich text at the beginning of the description is not recommended, as it will not get rendered properly. You should add a few lines of regular text before using rich text. -This license can be created for a new **Public Marketplace (all Mendix users)** component by requesting a new license and submitting it alongside the component. The license needs to be approved by Mendix after you have created and submitted it the first time. Once it has been submitted for approval, you and the people within your organization can also use it for other components. +4. From the **Industry** drop-down list, select up to three industries that are applicable to your component. -Follow these steps to configure a proprietary license for a new public component: +5. From the **Category** drop-down list, select up to three areas of expertise that are applicable to your component. -1. Click **Request New License**. -2. Add a **License Name**, which will be displayed on the [component details page](/appstore/component-details/). -3. Add a **License URL**, which should lead the user to a web page that lists the terms and conditions for using the component. Users can navigate to this web page by clicking the license name on the component details page. -4. Add a **Reason** for the new license. This is solely for Mendix review purposes, and will not be displayed on the component details page. +## Configuring Support and Licensing -#### Generating New Leads {#lead-generation} +On the **Support & Licensing** tab, add information about support, licensing, and visibility. -A lead is a potential sales contact that expresses interest in your product or service. Lead routing is the end-to-end process of collecting the leads and distributing them to you. It is possible to configure lead routing for the following content types in the Marketplace: +1. Add your **Website**. -* Solutions -* Industry templates +2. Add the **Contact Email** of your support department. -When prospective customers are interested in your product, they can leave their contact information using the Marketplace product listing. This is done by clicking a call-to-action button and filling in a form. +3. Select the **Visibility** of your component: -You can use one of these options as the name of your **Main call-to-action** button: + * **Public** – Your component will be available to the entire Mendix community. + This content must be reviewed and approved by Mendix before it is available. + * **Private** – Your content will receive the **Private** label, and be available only via your [Company Content](/appstore/home-page/#company-content) page. + Selected private content of a content group can also be made available to [content group guests](/appstore/home-page/#guests) for download. + This content is not reviewed by Mendix. + + You can only set the visibility in the initial version of your content. You cannot change this setting by updating the Marketplace component later. -* **Contact Us**, **Notify Me**, and **Request Demo** – Requires the email address that will receive the customer information. +4. Select the type of **License** you want applied to your app. + For details about the available open-source software licenses and their requirements, refer to [Open-Source Software Licenses](/appstore/licenses/). + + - {{% alert color="warning" %}}If you choose to add one of these buttons, customers can contact you directly. If you start talking with the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} +5. In the **Development Team** field, add the email addresses of the developers who have contributed to and own the component. -* **Download** – No lead routing is established, but customers can directly download your product. +## Adding Media and Documentation -In the **How would you like to receive information on new leads?** field, you must specify the email address or addresses where notifications and information can be sent. +On the **Media & Documentation** tab, add any resources to guide your users. -#### Adding an Icon +1. Use the **Upload Screenshots** option to add a maximum of 10 screenshots of your component. -To finish the configuration on the **General** page, click **Upload Image** to upload a cover image for your component. +2. In the **YouTube Video** field, add a URL for a demo of your component. -{{< figure src="/attachments/appstore/submit-content/general.png" >}} +3. In the **Documentation** field, add details on requirements and configuration for your component. + Follow the template for the recommended content: -### Package {#package} + * You must fill out the following sections in order to submit your component: + * The **Typical usage scenario** for the component + * The **Features and limitations** of the component + * These sections are optional: + * Any **Dependencies** (for example, the required Studio Pro version, modules, images, and styles) + * The **Installation** steps and details + * The **Configuration** steps and details + * Any **Known bugs** + * Any **Frequently Asked Questions** -{{% alert color="info" %}} -If you are using **Solutions**, you will not see the option to select your content source. If you are using **Industry Template**, selecting a content source is optional. -{{% /alert %}} + The editor comes with a set of basic formatting tools, such as bold, bullet lists, and URL links. + +4. In the **Resources** section, add up to 5 URLs for resources that your users might find useful, such as a GitHub URL. -1. Select one of the options for uploading the source file: +## Proprietary Licenses {#proprietary-license} -* **Manual upload** – Follow the steps in the dialog box for uploading the package source file. - When you are finished, click **Save**. -* **GitHub URL** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. - To include the repo's *README.md* file on the component's [Documentation](#doc) tab, make sure you have selected the **Import Documentation** box. - When you are finished, click **OK**. +You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. -2. Select the **Studio Pro Version** on which you built the content. - -3. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section will be automatically set to **1.0.0**. +This license can be created for a new **Public Marketplace (all Mendix users)** component by requesting a new license and submitting it alongside the component. The license needs to be approved by Mendix after you have created and submitted it the first time. Once it has been submitted for approval, you and the people within your organization can also use it for other components. -4. Enter **Release Notes** for the component in the box provided describing what is new in that release. +Follow these steps to configure a proprietary license for a new public component: -### Enable {#doc} +1. Click **Request New License**. +2. Add a **License Name**, which will be displayed on the [component details page](/appstore/component-details/). +3. Add a **License URL**, which should lead the user to a web page that lists the terms and conditions for using the component. Users can navigate to this web page by clicking the license name on the component details page. +4. Add a **Reason** for the new license. This is solely for Mendix review purposes, and will not be displayed on the component details page. -On the **Enable** page, in the **Documentation** section, you can enter details on requirements and configuration for your component. +## Generating New Leads {#lead-generation} -{{% alert color="info" %}} For GitHub uploads, the documentation option is only available if the **Import Documentation** box has not been selected on the **Package** page. -{{% /alert %}} +A lead is a potential sales contact that expresses interest in your product or service. Lead routing is the end-to-end process of collecting the leads and distributing them to you. It is possible to configure lead routing for the following content types in the Marketplace: -1. Follow the template for the recommended content: +* Solutions +* Industry templates -* You must fill out the following sections in order to submit your component: - * The **Typical usage scenario** for the component - * The **Features and limitations** of the component -* These sections are optional: - * Any **Dependencies** (for example, the required Studio Pro version, modules, images, and styles) - * The **Installation** steps and details - * The **Configuration** steps and details - * Any **Known bugs** - * Any **Frequently Asked Questions** +When prospective customers are interested in your product, they can leave their contact information using the Marketplace product listing. This is done by clicking a call-to-action button and filling in a form. -The editor comes with a set of basic formatting tools, such as bold, bullet lists, and URL links. +You can use one of these options as the name of your **Main call-to-action** button: -2. Click **Upload Screenshot** to upload images of the component from your computer. This is required for submitting a new component, and is especially important for configuration steps: +* **Contact Us**, **Notify Me**, and **Request Demo** – Requires the email address that will receive the customer information. -{{< figure src="/attachments/appstore/submit-content/enable.png" >}} + {{% alert color="warning" %}}If you choose to add one of these buttons, customers can contact you directly. If you start talking with the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} + +* **Download** – No lead routing is established, but customers can directly download your product. -3. (Optional) Add a **YouTube URL** and a **Demo URL**. +In the **How would you like to receive information on new leads?** field, you must specify the email address or addresses where notifications and information can be sent. -### Publish {#publish} +## Publishing {#publish} Finally, on the **Publish** page, you can review all the details you entered so far, and edit them if necessary before publishing. diff --git a/content/en/docs/marketplace/upload-content/governance-process.md b/content/en/docs/marketplace/upload-content/governance-process.md index 96f6a5cb435..eb19f0e4909 100644 --- a/content/en/docs/marketplace/upload-content/governance-process.md +++ b/content/en/docs/marketplace/upload-content/governance-process.md @@ -1,6 +1,7 @@ --- title: "Governance Process" url: /appstore/submit-content/governance-process/ +weight: 5 description: "Describes the Mendix processes for approving and reviewing Marketplace content." --- diff --git a/content/en/docs/marketplace/upload-content/licenses.md b/content/en/docs/marketplace/upload-content/licenses.md new file mode 100644 index 00000000000..6127294ecdb --- /dev/null +++ b/content/en/docs/marketplace/upload-content/licenses.md @@ -0,0 +1,29 @@ +--- +title: "Open-Source Software Licenses" +url: /appstore/licenses/ +weight: 4 +description: "Describes the open-source software license options available and their requirements." +--- + +## Introduction + +The following table describes the open-source software license options available and their requirements. + +{{% alert color="warning" %}} +Open-source software licenses must abide by a set of compliance rules to ensure the safety of the Mendix ecosystem. Refer to [OSS Compliance for External Developers](/appstore/submit-content/oss-compliance/) for details. +{{% /alert %}} + +| | **Notes** | **Commercial use allowed?** | **Component code needs to be in public repo?** | **License text required with copyright info in code and distribution artifact?** | **Can modify?** (Mention modifications to code) | **Can consuming apps use without making their code public?** | **Notice files should be distributed with artifact?** | **Original component source code to be distributed with consuming app?** | **Can sub-license?** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [MIT](https://opensource.org/licenses/MIT) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| **BSD 2.0, 3.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| **Apache 1.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| **Creative Commons CC0 1.0 Universal (CC-0)** (Public Domain) | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | + +{{% alert color="info" %}} +The [GNU General Public License (GPL), version 3](https://www.gnu.org/licenses/gpl-3.0.en.html) is not available to use, as everything licensed under GNU GPL is public. +GNU GPL has a strong copyleft effect. +Modification has a strong copyleft effect. +All consuming apps should make their code public. +{{% /alert %}} \ No newline at end of file diff --git a/content/en/docs/marketplace/upload-content/oss-compliance.md b/content/en/docs/marketplace/upload-content/oss-compliance.md index e6bcbc4a4a1..7280f70496c 100755 --- a/content/en/docs/marketplace/upload-content/oss-compliance.md +++ b/content/en/docs/marketplace/upload-content/oss-compliance.md @@ -1,6 +1,7 @@ --- title: "OSS Compliance for External Developers" url: /appstore/submit-content/oss-compliance/ +weight: 6 description: "Describes the criteria that must be met to ensure that Marketplace content is OSS-compliant." --- From 3ce0142a612d538f00ddaeefe178e380ca68aeba Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Fri, 18 Jul 2025 17:02:12 +0200 Subject: [PATCH 03/15] Fixed broken links --- .../create-content/guidelines-content-creators.md | 6 +++--- .../docs/marketplace/overview/component-details.md | 2 +- .../marketplace/overview/marketplace-home-page.md | 2 +- content/en/docs/marketplace/upload-content/_index.md | 12 ++++++++---- .../marketplace/upload-content/governance-process.md | 4 ++-- .../releasenotes/marketplace/general-marketplace.md | 8 ++++---- 6 files changed, 19 insertions(+), 15 deletions(-) diff --git a/content/en/docs/marketplace/create-content/guidelines-content-creators.md b/content/en/docs/marketplace/create-content/guidelines-content-creators.md index 555e22107c7..fca9c774a13 100644 --- a/content/en/docs/marketplace/create-content/guidelines-content-creators.md +++ b/content/en/docs/marketplace/create-content/guidelines-content-creators.md @@ -20,11 +20,11 @@ These are the general guidelines for creating new Marketplace content: * Your product must be complete and fully functional, as advertised upon submission. * In Mendix 10.21.0 and above, do not use direct associations in your module, as this can cause issues when it is imported. -When you add content to the Marketplace, include in the component [documentation](/appstore/submit-content/#doc) any information that the end-user should know. +When you add content to the Marketplace, include in the component documentation any information that the end-user should know. ## Using a GitHub Repository {#github} -You can set up a GitHub repository to contain the development content for your Marketplace component. During the submission process, you can share the repository URL as the component source on the [Package](/appstore/submit-content/#package) page. +You can set up a GitHub repository to contain the development content for your Marketplace component. During the submission process, you can share the repository URL as the component source on the [Upload Component](/appstore/submit-content/#general) tab. ### GitHub Repository Guidelines @@ -50,7 +50,7 @@ To create a new component release for the Mendix Marketplace, follow these steps {{< figure src="/attachments/appstore/submit-content/github-releases.png" >}} -5. Link this GitHub release to the upcoming Mendix Marketplace release by mentioning the GitHub release number in the description. For more details, see the [Package](/appstore/submit-content/#package) and [Updating Existing Marketplace Content](/appstore/submit-content/#updating) sections in *Upload to the Marketplace*. +5. Link this GitHub release to the upcoming Mendix Marketplace release by mentioning the GitHub release number in the description. For more details, see the [Uploading a Component](/appstore/submit-content/#general) and [Updating Existing Marketplace Content](/appstore/submit-content/#updating) sections in *Upload to the Marketplace*. ## Preparing Your Submission diff --git a/content/en/docs/marketplace/overview/component-details.md b/content/en/docs/marketplace/overview/component-details.md index 2ab04bfb1cb..7abb22063a3 100644 --- a/content/en/docs/marketplace/overview/component-details.md +++ b/content/en/docs/marketplace/overview/component-details.md @@ -43,7 +43,7 @@ The **Publisher** section includes the following information, depending on the t The **Requirements** section includes the following: * The Studio Pro version required for the component to work -* The type of [license](/appstore/submit-content/#license) for the component +* The type of [license](/appstore/licenses/) for the component The **Support** section presents the category of support Mendix offers for the component (for more details, see the [Marketplace Content Support](/appstore/marketplace-content-support/) section below). diff --git a/content/en/docs/marketplace/overview/marketplace-home-page.md b/content/en/docs/marketplace/overview/marketplace-home-page.md index edd2397641a..60aadf3821b 100644 --- a/content/en/docs/marketplace/overview/marketplace-home-page.md +++ b/content/en/docs/marketplace/overview/marketplace-home-page.md @@ -29,7 +29,7 @@ The search box at the top of the page allows you to explore the Mendix Marketpla You can refine search results using the following filters: * **Support** – Select between the available support categories. For details, see the [Marketplace Content Support](/appstore/marketplace-content-support/). -* **Visibility** – Choose whether you want to display [public](/appstore/submit-content/#public) or [private](/appstore/submit-content/#private) content. +* **Visibility** – Choose whether you want to display [public or private](/appstore/submit-content/#support-licensing) content. * **Content Types** – Choose the type of content to display. For details, see the [Types of Marketplace Components](/appstore/#components-type) section in *Marketplace*. * **Category** – Select specific domains in which components or services share characteristics, functions, or purposes. * **Industry** – Select specific sectors or business domains in which components or services are used. diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index c51f70b6316..fd32bb677f2 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -79,7 +79,7 @@ On the **General Information** tab, add more details about your component. 5. From the **Category** drop-down list, select up to three areas of expertise that are applicable to your component. -## Configuring Support and Licensing +## Configuring Support and Licensing {#support-licensing} On the **Support & Licensing** tab, add information about support, licensing, and visibility. @@ -129,7 +129,7 @@ On the **Media & Documentation** tab, add any resources to guide your users. 4. In the **Resources** section, add up to 5 URLs for resources that your users might find useful, such as a GitHub URL. -## Proprietary Licenses {#proprietary-license} +## Proprietary Licenses {#proprietary-license} You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. @@ -142,7 +142,9 @@ Follow these steps to configure a proprietary license for a new public component 3. Add a **License URL**, which should lead the user to a web page that lists the terms and conditions for using the component. Users can navigate to this web page by clicking the license name on the component details page. 4. Add a **Reason** for the new license. This is solely for Mendix review purposes, and will not be displayed on the component details page. -## Generating New Leads {#lead-generation} +## Generating New Leads {#lead-generation} + + A lead is a potential sales contact that expresses interest in your product or service. Lead routing is the end-to-end process of collecting the leads and distributing them to you. It is possible to configure lead routing for the following content types in the Marketplace: @@ -161,7 +163,9 @@ You can use one of these options as the name of your **Main call-to-action** but In the **How would you like to receive information on new leads?** field, you must specify the email address or addresses where notifications and information can be sent. -## Publishing {#publish} +## Publishing {#publish} + + Finally, on the **Publish** page, you can review all the details you entered so far, and edit them if necessary before publishing. diff --git a/content/en/docs/marketplace/upload-content/governance-process.md b/content/en/docs/marketplace/upload-content/governance-process.md index eb19f0e4909..30092c751b8 100644 --- a/content/en/docs/marketplace/upload-content/governance-process.md +++ b/content/en/docs/marketplace/upload-content/governance-process.md @@ -7,7 +7,7 @@ description: "Describes the Mendix processes for approving and reviewing Marketp ## Approval Process -All components that are to be listed in the [Public Marketplace](/appstore/submit-content/#public) are subject to an approval process to ensure the quality and accuracy of the listing and that the component meets the expectations of users. Component submissions are processed in a queue and reviewed on a first-come, first-served basis within five working days after submission. +All components that are to be listed in the [Public Marketplace](/appstore/submit-content/#support-licensing) are subject to an approval process to ensure the quality and accuracy of the listing and that the component meets the expectations of users. Component submissions are processed in a queue and reviewed on a first-come, first-served basis within five working days after submission. {{% alert color="warning" %}} Mendix strongly recommends performing the following checks before you submit your component for approval. This also speeds up the approval process. @@ -19,7 +19,7 @@ Mendix checks the following: * The licenses used in the uploaded *.mpk* files, using the [Fossology](https://fossology.osuosl.org/repo/) tool . There should be no use of GPL, LGPL, or MPL licenses. - For more details, see the [Providing License Details](/appstore/submit-content/#license) section in *Uploading to the Marketplace*. + For more details, refer to [Open-Source Software Licenses](/appstore/licenses/). * For malware in the *.mpk* files, using the [VirusTotal](https://www.virustotal.com/gui/home/upload) tool. * For third-party vulnerabilities, using the [Snyk](https://snyk.io/) tool. * That the component can be used without errors in a specific Studio Pro version, if the component is a widget, a module, a connector, or an industry template. diff --git a/content/en/docs/releasenotes/marketplace/general-marketplace.md b/content/en/docs/releasenotes/marketplace/general-marketplace.md index 461bd252f4c..9e088822a72 100644 --- a/content/en/docs/releasenotes/marketplace/general-marketplace.md +++ b/content/en/docs/releasenotes/marketplace/general-marketplace.md @@ -205,12 +205,12 @@ If you are using Studio Pro on a Mac with Parallels, see [this update](https://k * There are now user trials available for **Premium** app services, such as Email Service and Speech to Text. This self-service experience helps you to evaluate the capabilities offered with these components and realize the value of premium content. * User trial subscriptions are now listed under My Subscriptions, and company trial and paid subscriptions are now listed under Company Subscriptions. -* For new uploads of public components, you can now optionally share a [virus scan report](/appstore/submit-content/#package) to speed up the governance process. +* For new uploads of public components, you can now optionally share a virus scan report to speed up the governance process. * For solutions and solution templates, you can now add a use case relevant to the component. The use case is displayed in the component listing and includes header text and an external link. #### Improvements -* We made performance improvements for when a large source file is [uploaded](/appstore/submit-content/#package), specifically on the navigation steps. +* We made performance improvements for when a large source file is uploaded, specifically on the navigation steps. * We improved the UI for self-service uploading your component to the Marketplace. ### February 10, 2022 @@ -241,8 +241,8 @@ If you are using Studio Pro on a Mac with Parallels, see [this update](https://k #### Improvements -* You can now add [release notes](/appstore/submit-content/#package) for your new component version without uploading a new source file. -* You can now skip uploading a source file on the [Package](/appstore/submit-content/#package) page for **App Service** and **Solution Template** component types if your component is not downloadable. +* You can now add [release notes](/appstore/submit-content/#general) for your new component version without uploading a new source file. +* You can now skip uploading a source file on the [Upload Component](/appstore/submit-content/#general) tab for **App Service** and **Solution Template** component types if your component is not downloadable. ### September 7, 2021 From 07fc267efced660f51e0af1c3471c35d161fa6c4 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Fri, 18 Jul 2025 17:18:32 +0200 Subject: [PATCH 04/15] Fixed broken links --- content/en/docs/marketplace/upload-content/_index.md | 4 ++-- .../en/docs/marketplace/upload-content/governance-process.md | 4 +--- .../en/docs/releasenotes/marketplace/general-marketplace.md | 2 +- 3 files changed, 4 insertions(+), 6 deletions(-) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index fd32bb677f2..5144a902a68 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -48,7 +48,7 @@ Some only apply to specific component types, so follow the on-screen prompts for * **MPK File** – Upload your source MPK. * **GitHub Link** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. - To include the repo's *README.md* file on the component's [Documentation](#doc) tab, make sure you have selected the **Import Documentation** box. + To include the repo's *README.md* file on the component's [Media & Documentation](#doc) tab, make sure you have selected the **Import Documentation** box. If you are uploading a solution, there will be no option to select the content source. If you are uploading an industry template, selecting a content source is optional. @@ -104,7 +104,7 @@ On the **Support & Licensing** tab, add information about support, licensing, an 5. In the **Development Team** field, add the email addresses of the developers who have contributed to and own the component. -## Adding Media and Documentation +## Adding Media and Documentation {#doc} On the **Media & Documentation** tab, add any resources to guide your users. diff --git a/content/en/docs/marketplace/upload-content/governance-process.md b/content/en/docs/marketplace/upload-content/governance-process.md index 30092c751b8..499859b717e 100644 --- a/content/en/docs/marketplace/upload-content/governance-process.md +++ b/content/en/docs/marketplace/upload-content/governance-process.md @@ -32,10 +32,8 @@ It may sometimes take a few iterations for a component to be approved, depending {{% alert color="info" %}} Review and approval by Mendix is required only for the first version of a publicly-listed component. Subsequent versions of a public component do not need review or approval by Mendix. -{{% /alert %}} -{{% alert color="info" %}} -[Private Marketplace](/appstore/submit-content/#private) content does not require any review or approval. +Private Marketplace content does not require any review or approval. {{% /alert %}} ## Reviewing Outdated Components diff --git a/content/en/docs/releasenotes/marketplace/general-marketplace.md b/content/en/docs/releasenotes/marketplace/general-marketplace.md index 9e088822a72..f0528704b20 100644 --- a/content/en/docs/releasenotes/marketplace/general-marketplace.md +++ b/content/en/docs/releasenotes/marketplace/general-marketplace.md @@ -375,7 +375,7 @@ If you are using Studio Pro on a Mac with Parallels, see [this update](https://k #### Fixes {#private-fix} -* Downloading [private content](/appstore/submit-content/#private) from the App Store available in Studio Pro/Desktop Modeler has been temporarily disabled due to a security vulnerability. +* Downloading private content from the App Store available in Studio Pro/Desktop Modeler has been temporarily disabled due to a security vulnerability. * You will be able to download private content from the App Store available in Studio Pro/Desktop Modeler again once a fix is released in a future [8.x](/releasenotes/studio-pro/8/), [8.6.x](/releasenotes/studio-pro/8.6/), and 7.23.x release. This functionality will then only be available in those specific versions with the fix and subsequent versions. This functionality will not be available again for the App Store in Desktop Modeler version 6. * You can continue downloading the latest version of private App Store content from the [Company Content](/appstore/home-page/#company-content) page in the [Mendix Marketplace](https://marketplace.mendix.com/) and use it in the respective versions of Studio Pro/Desktop Modeler. From 1e42e47d851a5f0bf67eebb0b17ed82a4ffb023b Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Tue, 29 Jul 2025 13:41:15 +0200 Subject: [PATCH 05/15] Small updates per Figma --- .../docs/marketplace/upload-content/_index.md | 48 ++++++++++--------- 1 file changed, 26 insertions(+), 22 deletions(-) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 5144a902a68..1a249f171c3 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -32,7 +32,7 @@ On each page of the upload flow, click one of these buttons: * **Save and Exit** — Save the details you have entered so far for the draft. You can access the draft via the [My Drafts](/appstore/home-page/#my-drafts) link in the top bar. * **Next** — Go to the next page of the upload flow. -## Uploading a Component {#general} +### Uploading a Component {#general} On the **Upload Component** tab, add the source file, and provide general information about your component. @@ -64,7 +64,7 @@ Some only apply to specific component types, so follow the on-screen prompts for 8. If you are uploading a solution, enter an email address in the **Contact Sales** field. This will be used by customers to reach out to you. -## Adding General Information +### Adding General Information On the **General Information** tab, add more details about your component. @@ -79,7 +79,7 @@ On the **General Information** tab, add more details about your component. 5. From the **Category** drop-down list, select up to three areas of expertise that are applicable to your component. -## Configuring Support and Licensing {#support-licensing} +### Configuring Support and Licensing {#support-licensing} On the **Support & Licensing** tab, add information about support, licensing, and visibility. @@ -99,12 +99,23 @@ On the **Support & Licensing** tab, add information about support, licensing, an 4. Select the type of **License** you want applied to your app. For details about the available open-source software licenses and their requirements, refer to [Open-Source Software Licenses](/appstore/licenses/). - - 5. In the **Development Team** field, add the email addresses of the developers who have contributed to and own the component. -## Adding Media and Documentation {#doc} +#### Proprietary Licenses {#proprietary-license} + +You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. + +This license can be created for a new **Public Marketplace (all Mendix users)** component by requesting a new license and submitting it alongside the component. The license needs to be approved by Mendix after you have created and submitted it the first time. Once it has been submitted for approval, you and the people within your organization can also use it for other components. + +Follow these steps to configure a proprietary license for a new public component: + +1. Click **Request New License**. +2. Add a **License Name**, which will be displayed on the [component details page](/appstore/component-details/). +3. Add a **License URL**, which should lead the user to a web page that lists the terms and conditions for using the component. Users can navigate to this web page by clicking the license name on the component details page. +4. Add a **Reason** for the new license. This is solely for Mendix review purposes, and will not be displayed on the component details page. + +### Adding Media and Documentation {#doc} On the **Media & Documentation** tab, add any resources to guide your users. @@ -129,22 +140,9 @@ On the **Media & Documentation** tab, add any resources to guide your users. 4. In the **Resources** section, add up to 5 URLs for resources that your users might find useful, such as a GitHub URL. -## Proprietary Licenses {#proprietary-license} - -You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. - -This license can be created for a new **Public Marketplace (all Mendix users)** component by requesting a new license and submitting it alongside the component. The license needs to be approved by Mendix after you have created and submitted it the first time. Once it has been submitted for approval, you and the people within your organization can also use it for other components. - -Follow these steps to configure a proprietary license for a new public component: - -1. Click **Request New License**. -2. Add a **License Name**, which will be displayed on the [component details page](/appstore/component-details/). -3. Add a **License URL**, which should lead the user to a web page that lists the terms and conditions for using the component. Users can navigate to this web page by clicking the license name on the component details page. -4. Add a **Reason** for the new license. This is solely for Mendix review purposes, and will not be displayed on the component details page. - -## Generating New Leads {#lead-generation} +### Generating New Leads {#lead-generation} - + A lead is a potential sales contact that expresses interest in your product or service. Lead routing is the end-to-end process of collecting the leads and distributing them to you. It is possible to configure lead routing for the following content types in the Marketplace: @@ -163,7 +161,13 @@ You can use one of these options as the name of your **Main call-to-action** but In the **How would you like to receive information on new leads?** field, you must specify the email address or addresses where notifications and information can be sent. -## Publishing {#publish} +### Previewing the Component + +You can preview your component before publishing. To do that, click **Show Preview** on the **Media & Documentation** tab. + +From the preview window, you can either return to the editing flow, or publish the component. + +### Publishing {#publish} From 909ad644fd762baf7bf6bb3d271c5f9b66c03a81 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Mon, 11 Aug 2025 16:36:10 +0200 Subject: [PATCH 06/15] Minor changes --- content/en/docs/marketplace/upload-content/_index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 1a249f171c3..af3f9747ac7 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -42,7 +42,8 @@ Some only apply to specific component types, so follow the on-screen prompts for 1. Add a **Component Name**. 2. Select the **Component Type**. - You can only set the content type when creating the initial version of your content. You cannot change this setting after it is published. + You can only set the component type when creating the initial version of your content. You cannot change this setting after it is published. + Find out more about component types in the [Types of Marketplace Components](/appstore/#components-type) section of *Marketplace*. 3. Under **Select Component Source**, select one of the options for uploading the source file: @@ -58,7 +59,7 @@ Some only apply to specific component types, so follow the on-screen prompts for 5. If you are uploading a widget, select the **Compatible with Mendix React Client** checkbox to indicate compatibility. This checkbox is mandatory starting with Studio Pro 11. -6. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section will automatically be set to **1.0.0**. +6. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section is automatically set to **1.0.0**. 7. Enter **Release Notes** for the component in the box provided, describing what is new in that release. From c15a10dcb9e114b8a77106b94bfbea310be68332 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Fri, 15 Aug 2025 15:45:41 +0200 Subject: [PATCH 07/15] Updated per design changes --- .../docs/marketplace/upload-content/_index.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index af3f9747ac7..1a3fea6e202 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -45,7 +45,17 @@ Some only apply to specific component types, so follow the on-screen prompts for You can only set the component type when creating the initial version of your content. You cannot change this setting after it is published. Find out more about component types in the [Types of Marketplace Components](/appstore/#components-type) section of *Marketplace*. -3. Under **Select Component Source**, select one of the options for uploading the source file: +3. Select the **Visibility** of your component: + + * **Public** – Your component will be available to the entire Mendix community. + This content must be reviewed and approved by Mendix before it is available. + * **Private** – Your content will receive the **Private** label, and be available only via your [Company Content](/appstore/home-page/#company-content) page. + Selected private content of a content group can also be made available to [content group guests](/appstore/home-page/#guests) for download. + This content is not reviewed by Mendix. + + You can only set the visibility in the initial version of your content. You cannot change this setting by updating the Marketplace component later. + +4. Under **Select Component Source**, select one of the options for uploading the source file: * **MPK File** – Upload your source MPK. * **GitHub Link** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. @@ -54,16 +64,16 @@ Some only apply to specific component types, so follow the on-screen prompts for If you are uploading a solution, there will be no option to select the content source. If you are uploading an industry template, selecting a content source is optional. -4. Select the **Studio Pro Version** on which you built the content. +5. Select the **Studio Pro Version** on which you built the content. -5. If you are uploading a widget, select the **Compatible with Mendix React Client** checkbox to indicate compatibility. +6. If you are uploading a widget, select the **Compatible with Mendix React Client** checkbox to indicate compatibility. This checkbox is mandatory starting with Studio Pro 11. -6. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section is automatically set to **1.0.0**. +7. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section is automatically set to **1.0.0**. -7. Enter **Release Notes** for the component in the box provided, describing what is new in that release. +8. Enter **Release Notes** for the component in the box provided, describing what is new in that release. -8. If you are uploading a solution, enter an email address in the **Contact Sales** field. This will be used by customers to reach out to you. +9. If you are uploading a solution, enter an email address in the **Contact Sales** field. This will be used by customers to reach out to you. ### Adding General Information @@ -88,20 +98,10 @@ On the **Support & Licensing** tab, add information about support, licensing, an 2. Add the **Contact Email** of your support department. -3. Select the **Visibility** of your component: - - * **Public** – Your component will be available to the entire Mendix community. - This content must be reviewed and approved by Mendix before it is available. - * **Private** – Your content will receive the **Private** label, and be available only via your [Company Content](/appstore/home-page/#company-content) page. - Selected private content of a content group can also be made available to [content group guests](/appstore/home-page/#guests) for download. - This content is not reviewed by Mendix. - - You can only set the visibility in the initial version of your content. You cannot change this setting by updating the Marketplace component later. - -4. Select the type of **License** you want applied to your app. +3. Select the type of **License** you want applied to your app. For details about the available open-source software licenses and their requirements, refer to [Open-Source Software Licenses](/appstore/licenses/). -5. In the **Development Team** field, add the email addresses of the developers who have contributed to and own the component. +4. In the **Development Team** field, add the email addresses of the developers who have contributed to and own the component. #### Proprietary Licenses {#proprietary-license} @@ -139,7 +139,7 @@ On the **Media & Documentation** tab, add any resources to guide your users. The editor comes with a set of basic formatting tools, such as bold, bullet lists, and URL links. -4. In the **Resources** section, add up to 5 URLs for resources that your users might find useful, such as a GitHub URL. +4. In the **Resources** section, add up to 5 URLs for resources that your users might find useful, such as a **GitHub URL**. ### Generating New Leads {#lead-generation} From 42e8015ddbf908d5ba899e96eb0db5fd40e7c87c Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Fri, 26 Sep 2025 16:10:51 +0200 Subject: [PATCH 08/15] Updated per test env --- .../en/docs/marketplace/upload-content/_index.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 1a3fea6e202..9a7d93ac715 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -69,11 +69,11 @@ Some only apply to specific component types, so follow the on-screen prompts for 6. If you are uploading a widget, select the **Compatible with Mendix React Client** checkbox to indicate compatibility. This checkbox is mandatory starting with Studio Pro 11. -7. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section is automatically set to **1.0.0**. +7. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Release Version** section is automatically set to **1.0.0**. 8. Enter **Release Notes** for the component in the box provided, describing what is new in that release. -9. If you are uploading a solution, enter an email address in the **Contact Sales** field. This will be used by customers to reach out to you. +9. If you are uploading a solution or an industry template, enter one or more email addresses in the **Contact Email(s)** field, then click **Add Email**. These email addresses will be used by customers to reach out to you. ### Adding General Information @@ -81,7 +81,7 @@ On the **General Information** tab, add more details about your component. 1. Upload a cover image. -2. In the **Component Tagline**, include a short description of what your component does. +2. In the **Component Tagline** field, include a short description of what your component does. 3. In the **About** field, describe the purpose and use cases of your component in detail. You can use rich text in the editor. However, using rich text at the beginning of the description is not recommended, as it will not get rendered properly. You should add a few lines of regular text before using rich text. @@ -164,7 +164,7 @@ In the **How would you like to receive information on new leads?** field, you mu ### Previewing the Component -You can preview your component before publishing. To do that, click **Show Preview** on the **Media & Documentation** tab. +Once all steps of the upload flow are completed, you can preview your component before publishing. To do that, click **Next** on the **Media & Documentation** tab. From the preview window, you can either return to the editing flow, or publish the component. @@ -172,13 +172,9 @@ From the preview window, you can either return to the editing flow, or publish t -Finally, on the **Publish** page, you can review all the details you entered so far, and edit them if necessary before publishing. - -{{< figure src="/attachments/appstore/submit-content/publish.png" width="600" >}} - After you click **Publish Content**, your draft will be reviewed by Mendix before it is visible in the Marketplace. -For details on the approval process, see [Governance Process](/appstore/submit-content/governance-process/). +For details on the approval process, refer to [Governance Process](/appstore/submit-content/governance-process/). ## Updating Existing Marketplace Content {#updating} From 9cd9bab0b699df02e6c15869ac0329e80b329d54 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Mon, 29 Sep 2025 12:12:06 +0200 Subject: [PATCH 09/15] Changed per test env --- .../docs/marketplace/create-content/create-modules/_index.md | 2 +- content/en/docs/marketplace/overview/marketplace-home-page.md | 4 ++-- content/en/docs/marketplace/upload-content/_index.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/content/en/docs/marketplace/create-content/create-modules/_index.md b/content/en/docs/marketplace/create-content/create-modules/_index.md index 85cfdbde7a9..389bb6cc1f6 100644 --- a/content/en/docs/marketplace/create-content/create-modules/_index.md +++ b/content/en/docs/marketplace/create-content/create-modules/_index.md @@ -8,7 +8,7 @@ tags: ["marketplace", "content creation", "guidelines", "modules"] ## Introduction -Follow these guidelines when developing modules and submitting them to the Marketplace: +Follow these guidelines when developing modules for the Marketplace: * Create a folder named **USE_ME**, and add the microflows and pages that are relevant for the user. * Create an empty folder with the version number as its name, which will appear in Studio Pro's App Explorer. diff --git a/content/en/docs/marketplace/overview/marketplace-home-page.md b/content/en/docs/marketplace/overview/marketplace-home-page.md index 60aadf3821b..01d6ec1f603 100644 --- a/content/en/docs/marketplace/overview/marketplace-home-page.md +++ b/content/en/docs/marketplace/overview/marketplace-home-page.md @@ -40,11 +40,11 @@ You can refine search results using the following filters: For details on finding and installing Marketplace content in Studio Pro, see the [Finding and Downloading Content in Studio Pro](/appstore/use-content/#downloading) section of *Using Marketplace Content*. {{% /alert %}} -## Add Content +## Create Content Share new Marketplace content you have developed. -For details, see [Upload to the Marketplace](/appstore/submit-content/). +For details, see [Uploading Content to the Marketplace](/appstore/submit-content/). ## Get Studio Pro diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 9a7d93ac715..fa949ab0ab4 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -20,9 +20,9 @@ The Mendix Marketplace is driven by contributions from community members who sha Before diving in, make sure you have read [Marketplace Overview](/appstore/overview/) and [Using Marketplace Content](/appstore/use-content/). -## Adding New Marketplace Content {#adding} +## Creating New Marketplace Content {#adding} -To get started, click **Add Content** in the left pane of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. +To get started, click **Create Content** in the left pane of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. Once you make sure you have everything, click **Next**, then go through the steps in the following sections to add content. Some fields are mandatory, while others are optional — this is indicated in the user interface. From 16ef13f084aefdc801af1dce00c9b756bf46048e Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Wed, 1 Oct 2025 09:51:44 +0200 Subject: [PATCH 10/15] Added release note --- .../docs/marketplace/upload-content/_index.md | 2 ++ .../marketplace/general-marketplace.md | 19 +++++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index fa949ab0ab4..d960b021267 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -176,6 +176,8 @@ After you click **Publish Content**, your draft will be reviewed by Mendix befor For details on the approval process, refer to [Governance Process](/appstore/submit-content/governance-process/). +Every new public component or component version is scanned through QSM, and, if no vulnerabilities are found, it is automatically uploaded. In case of vulnerabilities, Mendix manually checks the component or component version. + ## Updating Existing Marketplace Content {#updating} After you publish a component in the Mendix Marketplace, it is your responsibility to make sure that the component is updated on a regular cadence. This is important to ensure compatibility with the latest versions of dependencies, especially Mendix Studio Pro. It is also required so Mendix can ensure the quality of components in the Marketplace. diff --git a/content/en/docs/releasenotes/marketplace/general-marketplace.md b/content/en/docs/releasenotes/marketplace/general-marketplace.md index 33c0b45982d..0e6c24dc9ca 100644 --- a/content/en/docs/releasenotes/marketplace/general-marketplace.md +++ b/content/en/docs/releasenotes/marketplace/general-marketplace.md @@ -12,6 +12,25 @@ aliases: These release notes cover changes made to the [Mendix Marketplace](/appstore/). +### October 9, 2025 + +#### Improvements + +We have made several improvements aimed at streamlining the experience of uploading content to the Marketplace and improving quality control: + +* The upload flow is now completely revamped, featuring a new interface and additional features, such as: + + * Adding multiple resource links, such as websites, to provide additional information. + * Assigning multiple developers from your company as component owners. + * Adding support information. + * Control over the image size, allowing you to crop screenshots for a better visual experience. + * Support for rich text in the release notes field. + * A new **Component Tagline** field, allowing you to add a short description that will be displayed on your component's card in the Marketplace. + * A new preview page, allowing you to see exactly what the component will look like once published. + +* New component versions are now also scanned, and automatically uploaded if no vulnerabilities are found. +* The email announcing a new version of a component now also includes release notes. + ### September 8, 2025 #### Improvements From 5b5dd58f2f3233c46932868e713471c5a5972299 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Wed, 1 Oct 2025 15:04:01 +0200 Subject: [PATCH 11/15] Reordered topics --- .../create-content/upload-content/_index.md | 220 ------------------ .../upload-content/governance-process.md | 2 +- .../marketplace/upload-content/licenses.md | 2 +- 3 files changed, 2 insertions(+), 222 deletions(-) delete mode 100644 content/en/docs/marketplace/create-content/upload-content/_index.md diff --git a/content/en/docs/marketplace/create-content/upload-content/_index.md b/content/en/docs/marketplace/create-content/upload-content/_index.md deleted file mode 100644 index 117d8c01928..00000000000 --- a/content/en/docs/marketplace/create-content/upload-content/_index.md +++ /dev/null @@ -1,220 +0,0 @@ ---- -title: "Uploading to the Marketplace" -url: /appstore/submit-content/ -weight: 6 -description_list: true -description: "Describes how to submit content to the Mendix Marketplace content." -tags: ["marketplace", "public marketplace", "private marketplace", widget", "module"] -aliases: - - /appstore/overview/share-content/ - - /appstore/general/share-app-store-content/ - - /developerportal/app-store/share-content/ -#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details. ---- - -## Introduction - -The Mendix Marketplace is driven by contributions from community members who share the connectors, modules, and apps they have built with the Mendix Platform. - -## Prerequisites - -Before starting this how-to, make sure you have completed the following prerequisites: - -* Familiarize yourself with [Marketplace Overview](/appstore/overview/) and [Using Marketplace Content](/appstore/use-content/). - -## Adding New Marketplace Content {#adding} - -To get started, click **Add Content** in the left pane of the Marketplace home screen. Follow the steps in these sections to add content. - -{{% alert color="info" %}} -On each page of the upload flow, click one of the following buttons: - -* **Save Draft** to save the details you have entered so far for the draft. You can access the draft via the [My Drafts](/appstore/home-page/#my-drafts) link in the top bar. -* **Save & Continue** to go to the next page of the upload flow. -{{% /alert %}} - -### General {#general} - -Provide key details about your component on the **General** page. - -#### Describing Your Content - -Follow these steps to describe your content: - -1. Select a **Content Type** for your component. - - {{% alert color="warning" %}}You can only set the content type when creating the initial version of your content. You cannot change this setting after it is published.{{% /alert %}} - -2. Select the **Visibility** of your component: - - * **Public Marketplace (all Mendix users)** – Your component will be available to the entire Mendix community. - * This content must be reviewed and approved by Mendix before it is available. - * **Private Marketplace (your company only)** – Your content will receive the **Private** label, and be available only via your [Company Content](/appstore/home-page/#company-content) page. - * Selected private content of a content group can also be made available to [content group guests](/appstore/home-page/#guests) for download. - * This content is not reviewed by Mendix. - {{% alert color="warning" %}}You can only set the visibility in the initial version of your content. You cannot change this setting by updating the Marketplace component later.{{% /alert %}} - -3. Add between one and three categories in the **Category** field. A category groups together similar components or services that share common characteristics, functions, or purposes. Categories make it easier for Marketplace users to find what they are looking for. -4. Enter a **Name** for your component. -5. Enter a **Description** of your component. - - {{% alert color="warning" %}} You can use rich text in the editor. However, using rich text at the beginning of the description is not recommended, as it will not get rendered properly. You should add a few lines of regular text before using rich text. {{% /alert %}} - -#### Providing License Details {#license} - -Select the type of **License** you want applied to your app. - -##### Open-Source Software Licenses - -{{% alert color="warning" %}} -Open-source software licenses must abide by a set of compliance rules to ensure the safety of the Mendix ecosystem. Refer to [OSS Compliance for External Developers](/appstore/submit-content/oss-compliance/) for details. -{{% /alert %}} - -These are the open-source software license options available and their requirements: - -| | **Notes** | **Commercial use allowed?** | **Component code needs to be in public repo?** | **License text required with copyright info in code and distribution artifact?** | **Can modify?** (Mention modifications to code) | **Can consuming apps use without making their code public?** | **Notice files should be distributed with artifact?** | **Original component source code to be distributed with consuming app?** | **Can sub-license?** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [MIT](https://opensource.org/licenses/MIT) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **BSD 2.0, 3.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **Apache 1.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **Creative Commons CC0 1.0 Universal (CC-0)** (Public Domain) | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | - -{{% alert color="info" %}} -The [GNU General Public License (GPL), version 3](https://www.gnu.org/licenses/gpl-3.0.en.html) is not available to use, as everything licensed under GNU GPL is public. -GNU GPL has a strong copyleft effect. -Modification has a strong copyleft effect. -All consuming apps should make their code public. -{{% /alert %}} - -##### Proprietary Licenses {#proprietary-license} - -You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. - -This license can be created for a new **Public Marketplace (all Mendix users)** component by requesting a new license and submitting it alongside the component. The license needs to be approved by Mendix after you have created and submitted it the first time. Once it has been submitted for approval, you and the people within your organization can also use it for other components. - -Follow these steps to configure a proprietary license for a new public component: - -1. Click **Request New License**. -2. Add a **License Name**, which will be displayed on the [component details page](/appstore/component-details/). -3. Add a **License URL**, which should lead the user to a web page that lists the terms and conditions for using the component. Users can navigate to this web page by clicking the license name on the component details page. -4. Add a **Reason** for the new license. This is solely for Mendix review purposes, and will not be displayed on the component details page. - -#### Generating New Leads {#lead-generation} - -A lead is a potential sales contact that expresses interest in your product or service. Lead routing is the end-to-end process of collecting the leads and distributing them to you. It is possible to configure lead routing for the following content types in the Marketplace: - -* Solutions -* Industry templates - -When prospective customers are interested in your product, they can leave their contact information using the Marketplace product listing. This is done by clicking a call-to-action button and filling in a form. - -You can use one of these options as the name of your **Main call-to-action** button: - -* **Contact Us**, **Notify Me**, and **Request Demo** – Requires the email address that will receive the customer information. - - {{% alert color="warning" %}}If you choose to add one of these buttons, customers can contact you directly. If you start talking with the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} - -* **Download** – No lead routing is established, but customers can directly download your product. - -In the **How would you like to receive information on new leads?** field, you must specify the email address or addresses where notifications and information can be sent. - -#### Adding an Icon - -To finish the configuration on the **General** page, click **Upload Image** to upload a cover image for your component. - -{{< figure src="/attachments/appstore/submit-content/general.png" >}} - -### Package {#package} - -{{% alert color="info" %}} -If you are using **Solutions**, you will not see the option to select your content source. If you are using **Industry Template**, selecting a content source is optional. -{{% /alert %}} - -1. Select one of the options for uploading the source file: - -* **Manual upload** – Follow the steps in the dialog box for uploading the package source file. - When you are finished, click **Save**. -* **GitHub URL** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. - To include the repo's *README.md* file on the component's [Documentation](#doc) tab, make sure you have selected the **Import Documentation** box. - When you are finished, click **OK**. - -2. Select the **Studio Pro Version** on which you built the content. - -3. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Version** section will be automatically set to **1.0.0**. - -4. Enter **Release Notes** for the component in the box provided describing what is new in that release. - -### Enable {#doc} - -On the **Enable** page, in the **Documentation** section, you can enter details on requirements and configuration for your component. - -{{% alert color="info" %}} For GitHub uploads, the documentation option is only available if the **Import Documentation** box has not been selected on the **Package** page. -{{% /alert %}} - -1. Follow the template for the recommended content: - -* You must fill out the following sections in order to submit your component: - * The **Typical usage scenario** for the component - * The **Features and limitations** of the component -* These sections are optional: - * Any **Dependencies** (for example, the required Studio Pro version, modules, images, and styles) - * The **Installation** steps and details - * The **Configuration** steps and details - * Any **Known bugs** - * Any **Frequently Asked Questions** - -The editor comes with a set of basic formatting tools, such as bold, bullet lists, and URL links. - -2. Click **Upload Screenshot** to upload images of the component from your computer. This is required for submitting a new component, and is especially important for configuration steps. - -{{< figure src="/attachments/appstore/submit-content/enable.png" >}} - -3. (Optional) Add a **YouTube URL** and a **Demo URL**. - -### Publish {#publish} - -Finally, on the **Publish** page, you can review all the details you entered so far, and edit them if necessary before publishing. - -{{< figure src="/attachments/appstore/submit-content/publish.png" width="600" >}} - -After you click **Publish Content**, your draft will be reviewed by Mendix before it is visible in the Marketplace. - -For details on the approval process, see [Governance Process](/appstore/submit-content/governance-process/). - -## Updating Existing Marketplace Content {#updating} - -After you publish a component in the Mendix Marketplace, it is your responsibility to make sure that the component is updated on a regular cadence. This is important to ensure compatibility with the latest versions of dependencies, especially Mendix Studio Pro. It is also required so Mendix can ensure the quality of components in the Marketplace. - -This means you need to monitor, maintain, and evolve the component, thus making sure that the Marketplace listing is more noticeable, that you can build user loyalty, and that you can maintain the good reputation of your company. - -If the component is not updated regularly, the Marketplace listing will be analyzed for removal from public visibility. - -Mendix expects the following updates for components in the Platform, Community, and Premium [support categories](/appstore/marketplace-content-support/#category): - -* Bug fixes -* New features -* Feature removal -* Compatibility updates with the latest Studio Pro version and other dependencies - -To update content that has already been published, follow these steps: - -1. Find the component in one of the following sections: - - * **My Content** - * **Company Content** - * **Content Group** - {{% alert color="info" %}}If an existing Marketplace component is assigned to a [content group](/appstore/home-page/#content-groups) as specific content group [content](/appstore/home-page/#group-content), you can only update the component if you are a member of that group.{{% /alert %}} - -2. Click the menu item next to the component you want to update and select **Manage Draft**. - - {{% alert color="info" %}}Only one draft version of a component can exist at a time, so when one draft version is in progress, another draft cannot be started. If there is a draft version in progress, click **Edit Draft** on the page where you manage the component in order to see the draft.{{% /alert %}} - -3. You can edit all component details, as described in the [Adding New Marketplace Content](#adding) section above. -4. In the **Version** section of the **Package** page, update the **Major**, **Minor**, and **Patch** numbers so that the component is saved as a new version: - - * **Major update** – changes that break compatibility with earlier versions. - * **Minor update** – new features that do not break existing usage. - * **Patch** – a small change that fixes bugs or security issues. - -5. On the **Publish** page, you can review all the details of your component entered so far and edit as necessary using the **Edit** button in each section before clicking **Publish Content**. diff --git a/content/en/docs/marketplace/upload-content/governance-process.md b/content/en/docs/marketplace/upload-content/governance-process.md index 499859b717e..b5f5dddbcb4 100644 --- a/content/en/docs/marketplace/upload-content/governance-process.md +++ b/content/en/docs/marketplace/upload-content/governance-process.md @@ -1,7 +1,7 @@ --- title: "Governance Process" url: /appstore/submit-content/governance-process/ -weight: 5 +weight: 4 description: "Describes the Mendix processes for approving and reviewing Marketplace content." --- diff --git a/content/en/docs/marketplace/upload-content/licenses.md b/content/en/docs/marketplace/upload-content/licenses.md index 6127294ecdb..2683148991f 100644 --- a/content/en/docs/marketplace/upload-content/licenses.md +++ b/content/en/docs/marketplace/upload-content/licenses.md @@ -1,7 +1,7 @@ --- title: "Open-Source Software Licenses" url: /appstore/licenses/ -weight: 4 +weight: 5 description: "Describes the open-source software license options available and their requirements." --- From bac7eaffe610bc74f8100975aa496c65cdfcb0af Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Thu, 2 Oct 2025 11:37:46 +0200 Subject: [PATCH 12/15] Implemented feedback --- .../overview/marketplace-home-page.md | 2 +- .../docs/marketplace/upload-content/_index.md | 96 ++++++++++++------- .../marketplace/upload-content/licenses.md | 29 ------ 3 files changed, 60 insertions(+), 67 deletions(-) delete mode 100644 content/en/docs/marketplace/upload-content/licenses.md diff --git a/content/en/docs/marketplace/overview/marketplace-home-page.md b/content/en/docs/marketplace/overview/marketplace-home-page.md index 85633a21574..f42c778581c 100644 --- a/content/en/docs/marketplace/overview/marketplace-home-page.md +++ b/content/en/docs/marketplace/overview/marketplace-home-page.md @@ -40,7 +40,7 @@ You can refine search results using the following filters: For details on finding and installing Marketplace content in Studio Pro, see the [Finding and Downloading Content in Studio Pro](/appstore/use-content/#downloading) section of *Using Marketplace Content*. {{% /alert %}} -## Create Content +## Add Content Share new Marketplace content you have developed. diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index d960b021267..18aa3200ebe 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -20,16 +20,17 @@ The Mendix Marketplace is driven by contributions from community members who sha Before diving in, make sure you have read [Marketplace Overview](/appstore/overview/) and [Using Marketplace Content](/appstore/use-content/). -## Creating New Marketplace Content {#adding} +## Adding New Marketplace Content {#adding} -To get started, click **Create Content** in the left pane of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. +To get started, click **Add Content** in the left pane of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. Once you make sure you have everything, click **Next**, then go through the steps in the following sections to add content. Some fields are mandatory, while others are optional — this is indicated in the user interface. On each page of the upload flow, click one of these buttons: -* **Save and Exit** — Save the details you have entered so far for the draft. You can access the draft via the [My Drafts](/appstore/home-page/#my-drafts) link in the top bar. +* **Save and Exit** — Save the details you have entered so far for the draft. You can access the draft via the [My Drafts](/appstore/home-page/#my-drafts) link in the top bar. + This button is not displayed if you are editing a component. * **Next** — Go to the next page of the upload flow. ### Uploading a Component {#general} @@ -58,8 +59,8 @@ Some only apply to specific component types, so follow the on-screen prompts for 4. Under **Select Component Source**, select one of the options for uploading the source file: * **MPK File** – Upload your source MPK. - * **GitHub Link** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. - To include the repo's *README.md* file on the component's [Media & Documentation](#doc) tab, make sure you have selected the **Import Documentation** box. + * **GitHub Link** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. + If you choose to import the source file from GitHub, the GitHub URL will automatically be displayed in the **Resources** section in Marketplace. If you are uploading a solution, there will be no option to select the content source. If you are uploading an industry template, selecting a content source is optional. @@ -71,15 +72,22 @@ Some only apply to specific component types, so follow the on-screen prompts for 7. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Release Version** section is automatically set to **1.0.0**. -8. Enter **Release Notes** for the component in the box provided, describing what is new in that release. +8. Enter **Release Notes** for the component in the box provided, describing what is new in that release. This field supports rich text. -9. If you are uploading a solution or an industry template, enter one or more email addresses in the **Contact Email(s)** field, then click **Add Email**. These email addresses will be used by customers to reach out to you. +9. If you are uploading a solution or an industry template, enter one or more email addresses in the **Contact Email(s)** field, then click **Add Email**. These email addresses will be used by customers to reach out to you. + +#### Connecting with Prospects + +A prospect is a potential sales contact that expresses interest in your product or service. If you create a solution or an industry template, you can use the **Business Connect** section of the **Upload Component** step to connect directly with new prospects. +To do that, enter up to ten email addresses in the **Contact Email(s)** field. Prospects can use these email addresses to get in touch with you. + +{{% alert color="warning" %}}Please note that potential customers can contact you directly. If you start talking to the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} ### Adding General Information On the **General Information** tab, add more details about your component. -1. Upload a cover image. +1. Upload a cover image. The suggested image resolution is 600x240 px. 2. In the **Component Tagline** field, include a short description of what your component does. @@ -94,15 +102,39 @@ On the **General Information** tab, add more details about your component. On the **Support & Licensing** tab, add information about support, licensing, and visibility. -1. Add your **Website**. +1. Select the **License Type** you want applied to your app. + For details about the available open-source software licenses and their requirements, refer to [Open-Source Software Licenses](#license). + {{% alert color="info" %}}If you select BSD 2.0, BSD 3.0, or Apache 1.0, you need to provide the link to the public repository where the component is stored.{{% /alert %}} -2. Add the **Contact Email** of your support department. +2. Add your **Website**. -3. Select the type of **License** you want applied to your app. - For details about the available open-source software licenses and their requirements, refer to [Open-Source Software Licenses](/appstore/licenses/). +3. Add the **Contact Email** of your support department. 4. In the **Development Team** field, add the email addresses of the developers who have contributed to and own the component. +#### Open-Source Software Licenses {#license} + +The following table describes the open-source software license options available and their requirements. + +{{% alert color="warning" %}} +Open-source software licenses must abide by a set of compliance rules to ensure the safety of the Mendix ecosystem. Refer to [OSS Compliance for External Developers](/appstore/submit-content/oss-compliance/) for details. +{{% /alert %}} + +| | **Notes** | **Commercial use allowed?** | **Component code needs to be in public repo?** | **License text required with copyright info in code and distribution artifact?** | **Can modify?** (Mention modifications to code) | **Can consuming apps use without making their code public?** | **Notice files should be distributed with artifact?** | **Original component source code to be distributed with consuming app?** | **Can sub-license?** | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| [MIT](https://opensource.org/licenses/MIT) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| **BSD 2.0, 3.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| **Apache 1.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | +| **Creative Commons CC0 1.0 Universal (CC-0)** (Public Domain) | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | + +{{% alert color="info" %}} +The [GNU General Public License (GPL), version 3](https://www.gnu.org/licenses/gpl-3.0.en.html) is not available to use, as everything licensed under GNU GPL is public. +GNU GPL has a strong copyleft effect. +Modification has a strong copyleft effect. +All consuming apps should make their code public. +{{% /alert %}} + #### Proprietary Licenses {#proprietary-license} You can configure your own proprietary license for your company’s content. The license can be applied to multiple components, and it can be used by everyone within your organization. @@ -120,7 +152,8 @@ Follow these steps to configure a proprietary license for a new public component On the **Media & Documentation** tab, add any resources to guide your users. -1. Use the **Upload Screenshots** option to add a maximum of 10 screenshots of your component. +1. Use the **Upload Screenshots** option to add a maximum of 10 screenshots of your component. + The suggested image ratio is 16:9. 2. In the **YouTube Video** field, add a URL for a demo of your component. @@ -137,42 +170,29 @@ On the **Media & Documentation** tab, add any resources to guide your users. * Any **Known bugs** * Any **Frequently Asked Questions** - The editor comes with a set of basic formatting tools, such as bold, bullet lists, and URL links. + This field supports rich text. 4. In the **Resources** section, add up to 5 URLs for resources that your users might find useful, such as a **GitHub URL**. -### Generating New Leads {#lead-generation} - - - -A lead is a potential sales contact that expresses interest in your product or service. Lead routing is the end-to-end process of collecting the leads and distributing them to you. It is possible to configure lead routing for the following content types in the Marketplace: +5. Click **Show Preview** if you want to preview your component, or **Publish** if you want to publish it directly. -* Solutions -* Industry templates - -When prospective customers are interested in your product, they can leave their contact information using the Marketplace product listing. This is done by clicking a call-to-action button and filling in a form. - -You can use one of these options as the name of your **Main call-to-action** button: - -* **Contact Us**, **Notify Me**, and **Request Demo** – Requires the email address that will receive the customer information. - - {{% alert color="warning" %}}If you choose to add one of these buttons, customers can contact you directly. If you start talking with the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} - -* **Download** – No lead routing is established, but customers can directly download your product. +### Previewing the Component -In the **How would you like to receive information on new leads?** field, you must specify the email address or addresses where notifications and information can be sent. +Once all steps of the upload flow are completed, you can preview your component before publishing. To do that, click **Show Preview** on the **Media & Documentation** tab. This displays your component exactly as it will look like in the Marketplace. -### Previewing the Component +From the preview window, you can either return to the editing flow, or publish the component. -Once all steps of the upload flow are completed, you can preview your component before publishing. To do that, click **Next** on the **Media & Documentation** tab. +If you choose to publish the component, you will see one of these two buttons: -From the preview window, you can either return to the editing flow, or publish the component. +* **Publish Component** — This is displayed when publishing a new component or component version. +* **Publish Changes** — This is displayed when publishing changes to an existing component. ### Publishing {#publish} -After you click **Publish Content**, your draft will be reviewed by Mendix before it is visible in the Marketplace. +After you click **Publish Content**, your draft will be reviewed by Mendix before it is visible in the Marketplace. > only if the component is public. +If the component is private, it is either checked by the company admin or it gets published automatically (depending on your choice). It may take a short while before the component is visible. For details on the approval process, refer to [Governance Process](/appstore/submit-content/governance-process/). @@ -180,7 +200,7 @@ Every new public component or component version is scanned through QSM, and, if ## Updating Existing Marketplace Content {#updating} -After you publish a component in the Mendix Marketplace, it is your responsibility to make sure that the component is updated on a regular cadence. This is important to ensure compatibility with the latest versions of dependencies, especially Mendix Studio Pro. It is also required so Mendix can ensure the quality of components in the Marketplace. +After you publish a component to the Mendix Marketplace, it is your responsibility to make sure that the component is updated on a regular cadence. This is important to ensure compatibility with the latest versions of dependencies, especially Mendix Studio Pro. It is also required so Mendix can ensure the quality of components in the Marketplace. This means you need to monitor, maintain, and evolve the component, thus making sure that the Marketplace listing is more noticeable, that you can build user loyalty, and that you can maintain the good reputation of your company. @@ -214,3 +234,5 @@ To update content that has already been published, follow these steps: * **Patch** – a small change that fixes bugs or security issues. 5. On the **Publish** page, you can review all the details of your component entered so far and edit as necessary using the **Edit** button in each section before clicking **Publish Content**. + + diff --git a/content/en/docs/marketplace/upload-content/licenses.md b/content/en/docs/marketplace/upload-content/licenses.md deleted file mode 100644 index 2683148991f..00000000000 --- a/content/en/docs/marketplace/upload-content/licenses.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Open-Source Software Licenses" -url: /appstore/licenses/ -weight: 5 -description: "Describes the open-source software license options available and their requirements." ---- - -## Introduction - -The following table describes the open-source software license options available and their requirements. - -{{% alert color="warning" %}} -Open-source software licenses must abide by a set of compliance rules to ensure the safety of the Mendix ecosystem. Refer to [OSS Compliance for External Developers](/appstore/submit-content/oss-compliance/) for details. -{{% /alert %}} - -| | **Notes** | **Commercial use allowed?** | **Component code needs to be in public repo?** | **License text required with copyright info in code and distribution artifact?** | **Can modify?** (Mention modifications to code) | **Can consuming apps use without making their code public?** | **Notice files should be distributed with artifact?** | **Original component source code to be distributed with consuming app?** | **Can sub-license?** | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | -| [MIT](https://opensource.org/licenses/MIT) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **BSD 2.0, 3.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **Apache 1.0** | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) | Add a specific *license.txt* file in your artifacts, i.e. in the *.mpk* package. | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | -| **Creative Commons CC0 1.0 Universal (CC-0)** (Public Domain) | N/A | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="remove-circle-filled" color="red" >}} | {{< icon name="checkmark-circle-filled" color="green" >}} | - -{{% alert color="info" %}} -The [GNU General Public License (GPL), version 3](https://www.gnu.org/licenses/gpl-3.0.en.html) is not available to use, as everything licensed under GNU GPL is public. -GNU GPL has a strong copyleft effect. -Modification has a strong copyleft effect. -All consuming apps should make their code public. -{{% /alert %}} \ No newline at end of file From 98ec50966410a9a75aca98620c7e12e237cffdf2 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Thu, 2 Oct 2025 13:53:14 +0200 Subject: [PATCH 13/15] Added uneditable fields --- content/en/docs/marketplace/upload-content/_index.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 18aa3200ebe..61dbe80129a 100644 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -235,4 +235,12 @@ To update content that has already been published, follow these steps: 5. On the **Publish** page, you can review all the details of your component entered so far and edit as necessary using the **Edit** button in each section before clicking **Publish Content**. +These fields cannot be edited while updating a component: + +* **Component Type** +* **Visibility** +* **Component Source** +* **Studio Pro Version** +* **Release Version** +* **License Type** From 702f145475468bfea42d5891d194c390254924c2 Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Tue, 7 Oct 2025 13:16:46 +0200 Subject: [PATCH 14/15] Applied feedback --- .../docs/marketplace/upload-content/_index.md | 40 ++++++++++--------- 1 file changed, 21 insertions(+), 19 deletions(-) mode change 100644 => 100755 content/en/docs/marketplace/upload-content/_index.md diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md old mode 100644 new mode 100755 index 61dbe80129a..8d893099466 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -22,7 +22,7 @@ Before diving in, make sure you have read [Marketplace Overview](/appstore/overv ## Adding New Marketplace Content {#adding} -To get started, click **Add Content** in the left pane of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. +To get started, click **Add Content** in the left panel of the Marketplace home screen. You are presented with the **Before You Get Started** dialog, which outlines the resources you will need for uploading your component. Once you make sure you have everything, click **Next**, then go through the steps in the following sections to add content. Some fields are mandatory, while others are optional — this is indicated in the user interface. @@ -36,9 +36,8 @@ On each page of the upload flow, click one of these buttons: ### Uploading a Component {#general} On the **Upload Component** tab, add the source file, and provide general information about your component. - -Follow these steps to add information about your component. -Some only apply to specific component types, so follow the on-screen prompts for your particular scenario. + +Some fields only apply to specific component types, so follow the on-screen prompts for your particular scenario. 1. Add a **Component Name**. @@ -62,26 +61,25 @@ Some only apply to specific component types, so follow the on-screen prompts for * **GitHub Link** – Follow the steps in the dialog box for copying the link of the release you want to import. For details, see the [Using a GitHub Repo](/appstore/guidelines-content-creators/#github) section in *Guidelines for Content Creators*. If you choose to import the source file from GitHub, the GitHub URL will automatically be displayed in the **Resources** section in Marketplace. - If you are uploading a solution, there will be no option to select the content source. - If you are uploading an industry template, selecting a content source is optional. + If you are uploading a solution, the **Upload Component Source** section is not displayed. + If you are uploading an industry template, selecting a component source in the **Upload Component Source** section is optional. 5. Select the **Studio Pro Version** on which you built the content. 6. If you are uploading a widget, select the **Compatible with Mendix React Client** checkbox to indicate compatibility. This checkbox is mandatory starting with Studio Pro 11. -7. Add a version for your component. If this is the first version of the component you are uploading, the number in the **Release Version** section is automatically set to **1.0.0**. +7. Add a version for your component. 8. Enter **Release Notes** for the component in the box provided, describing what is new in that release. This field supports rich text. -9. If you are uploading a solution or an industry template, enter one or more email addresses in the **Contact Email(s)** field, then click **Add Email**. These email addresses will be used by customers to reach out to you. +9. If you are uploading a solution or an industry template, the **Business Connect** section is displayed. Enter one or more email addresses in the **Contact Email(s)** field, then click **Add Email**. These email addresses will be used by prospects to reach out to you. + This field is only available for public components. + {{% alert color="warning" %}}Please note that potential customers can contact you directly. If you start talking to the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} + -#### Connecting with Prospects -A prospect is a potential sales contact that expresses interest in your product or service. If you create a solution or an industry template, you can use the **Business Connect** section of the **Upload Component** step to connect directly with new prospects. -To do that, enter up to ten email addresses in the **Contact Email(s)** field. Prospects can use these email addresses to get in touch with you. -{{% alert color="warning" %}}Please note that potential customers can contact you directly. If you start talking to the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} ### Adding General Information @@ -100,7 +98,7 @@ On the **General Information** tab, add more details about your component. ### Configuring Support and Licensing {#support-licensing} -On the **Support & Licensing** tab, add information about support, licensing, and visibility. +On the **Support & Licensing** tab, select your license type, and add contact details. 1. Select the **License Type** you want applied to your app. For details about the available open-source software licenses and their requirements, refer to [Open-Source Software Licenses](#license). @@ -189,10 +187,11 @@ If you choose to publish the component, you will see one of these two buttons: ### Publishing {#publish} - +If the component is public, once you click **Publish Content**, your draft will be reviewed by Mendix before it becomes visible in the Marketplace. + +If the component is private, the draft is either checked by the company admin, or it is published automatically, depending on your choice. -After you click **Publish Content**, your draft will be reviewed by Mendix before it is visible in the Marketplace. > only if the component is public. -If the component is private, it is either checked by the company admin or it gets published automatically (depending on your choice). It may take a short while before the component is visible. +Note that it may take a short while before the component becomes visible. For details on the approval process, refer to [Governance Process](/appstore/submit-content/governance-process/). @@ -222,7 +221,11 @@ To update content that has already been published, follow these steps: * **Content Group** {{% alert color="info" %}}If an existing Marketplace component is assigned to a [content group](/appstore/home-page/#content-groups) as specific content group [content](/appstore/home-page/#group-content), you can only update the component if you are a member of that group.{{% /alert %}} -2. Click the menu item next to the component you want to update and select **Manage Draft**. +2. Click the menu item next to the component you want to update and select the appropriate option, depending on your access rights: + + * **Edit** + * **Unpublish Component** + * **Add New Version** {{% alert color="info" %}}Only one draft version of a component can exist at a time, so when one draft version is in progress, another draft cannot be started. If there is a draft version in progress, click **Edit Draft** on the page where you manage the component in order to see the draft.{{% /alert %}} @@ -233,7 +236,7 @@ To update content that has already been published, follow these steps: * **Minor update** – new features that do not break existing usage. * **Patch** – a small change that fixes bugs or security issues. -5. On the **Publish** page, you can review all the details of your component entered so far and edit as necessary using the **Edit** button in each section before clicking **Publish Content**. +5. On the **Preview** page, you can review all the details of your component entered so far, and edit as necessary using the **Back to Edit** button. Once done, click **Publish Content**. These fields cannot be edited while updating a component: @@ -243,4 +246,3 @@ These fields cannot be edited while updating a component: * **Studio Pro Version** * **Release Version** * **License Type** - From c3b3642fbc90fc9c6dbeae58a59c9ed21c98711f Mon Sep 17 00:00:00 2001 From: nicoletacoman Date: Thu, 9 Oct 2025 13:13:49 +0200 Subject: [PATCH 15/15] Fixed broken links --- content/en/docs/marketplace/overview/component-details.md | 2 +- content/en/docs/marketplace/upload-content/_index.md | 4 ---- .../en/docs/marketplace/upload-content/governance-process.md | 2 +- 3 files changed, 2 insertions(+), 6 deletions(-) diff --git a/content/en/docs/marketplace/overview/component-details.md b/content/en/docs/marketplace/overview/component-details.md index 7abb22063a3..2ab04bfb1cb 100644 --- a/content/en/docs/marketplace/overview/component-details.md +++ b/content/en/docs/marketplace/overview/component-details.md @@ -43,7 +43,7 @@ The **Publisher** section includes the following information, depending on the t The **Requirements** section includes the following: * The Studio Pro version required for the component to work -* The type of [license](/appstore/licenses/) for the component +* The type of [license](/appstore/submit-content/#license) for the component The **Support** section presents the category of support Mendix offers for the component (for more details, see the [Marketplace Content Support](/appstore/marketplace-content-support/) section below). diff --git a/content/en/docs/marketplace/upload-content/_index.md b/content/en/docs/marketplace/upload-content/_index.md index 8d893099466..a70189246b5 100755 --- a/content/en/docs/marketplace/upload-content/_index.md +++ b/content/en/docs/marketplace/upload-content/_index.md @@ -77,10 +77,6 @@ Some fields only apply to specific component types, so follow the on-screen prom This field is only available for public components. {{% alert color="warning" %}}Please note that potential customers can contact you directly. If you start talking to the customer, it is your responsibility to provide access to the product for them. Mendix is not involved in such customer interactions. {{% /alert %}} - - - - ### Adding General Information On the **General Information** tab, add more details about your component. diff --git a/content/en/docs/marketplace/upload-content/governance-process.md b/content/en/docs/marketplace/upload-content/governance-process.md index b5f5dddbcb4..822c98e7128 100644 --- a/content/en/docs/marketplace/upload-content/governance-process.md +++ b/content/en/docs/marketplace/upload-content/governance-process.md @@ -19,7 +19,7 @@ Mendix checks the following: * The licenses used in the uploaded *.mpk* files, using the [Fossology](https://fossology.osuosl.org/repo/) tool . There should be no use of GPL, LGPL, or MPL licenses. - For more details, refer to [Open-Source Software Licenses](/appstore/licenses/). + For more details, refer to [Open-Source Software Licenses](/appstore/submit-content/#license). * For malware in the *.mpk* files, using the [VirusTotal](https://www.virustotal.com/gui/home/upload) tool. * For third-party vulnerabilities, using the [Snyk](https://snyk.io/) tool. * That the component can be used without errors in a specific Studio Pro version, if the component is a widget, a module, a connector, or an industry template.