Marketplace Overview

Last update: Edit

1 Introduction

The Mendix Marketplace is a vibrant marketplace containing complete sample apps that can be used right away as well as various components (connectors, widgets, and modules) that can be used to build custom apps more quickly. In the Mendix Marketplace, you can browse all the content, get what you need, and share the content you have created.

This document describes the different sections of the Mendix Marketplace.

2 Marketplace Home Page

The home page is your entry point to the various parts of the Mendix Marketplace. Here you can perform actions such as the following:

The Marketplace offers Industry solutions for manufacturing, financial services, and other industries.

The Marketplace offers the following Content Types:

Type Description
Solutions Out-of-the-box solutions are aimed at industries and domain problems, and they deliver instant value. These solutions can be adapted using the core Mendix Platform to fully meet your requirements.
Templates Templates and starter apps serve as accelerators for implementing solutions to help increase speed-to-value and time-to-market.
App Services App services are packages of preconfigured business capabilities provided as modules containing logic, UIs, workflows, connectors, and APIs.
Connectors Connectors are for connecting data services. They have content that you can drag from the Connector pane in Studio Pro into your app.
Modules Modules are packages of functionality for your app. They consist of a domain model, security options, and other elements like microflows, pages, or Java actions. Modules are mostly used for complex functionality that needs business or Java logic.
Widgets Widgets are single user-interface elements like containers, drop-down menus, and buttons. Select a widget, configure it, and add it to pages and snippets in your app.
Platform Services These services for Mendix Platform integration accessible through the Marketplace include Data Hub.

The following filter options are also available:

  • Compatibility
  • Tags
  • Rating

3 Component Details Page

Clicking the tile of a Marketplace component will bring you to its details page with the sections described below.

3.1 Header & Usage

The header for a component presents the following details:

  • The name and category of the component
  • The review average (in stars) and the number of reviews
  • The number of times the component has been downloaded
  • The Add to Saved button which, when clicked, will add the component to the list on the My Marketplace
  • The Share button, which allows you to copy the URL of the component and share it to your networks
  • Download – click this to download the component
    • This is only available for components that have a file attached (meaning, all shared Studio Pro components, but not promotions)
    • The best practice is to download a component from the Marketplace that is accessible in Studio Pro, because it then downloads directly into Studio Pro (for details on importing downloaded Marketplace content into Studio Pro, see How to Import & Export Objects)
  • The Premium label is applied to components like app services that require a subscription; some premium services (like Email Service) also offer a free trial based on a predefined quota/limit
    • These components have a Subscribe button to start your subscription and a Try for Free button to start your free trial
    • If you have an active trial or a subscription for a component, click Check Status to go to the Subscriptions page
    • These components also have a Pricing tab
  • The Request Demo and Contact Sales buttons are only available for industry solutions

The Usage section presents the following information (depending on the type of component):

  • The latest Version number of the component
  • The Studio Pro version that the component Requires to work
  • The type of license for the component

The Publisher section presents the name of the company who created the component as well as the Date when the component was first published.

The Developers section presents the names of the developers who most recently updated the component, with links to their Mendix Profile.

The Support section presents the category of support Mendix offers for the component (for more details, see Marketplace Content Support).

A GitHub link will take you to the GitHub source files of the component.

3.2 Tabs

The details page for a component presents the following item information tabs:

  • Overview – contains the following sections:
    • Description – a description of the component
    • Screenshots – screenshots of the component
    • User Reviews – user reviews of the component; to leave a review for the component, click Add Review, which will open a section where you can add text, rate the component, and submit the review (your reviews will be listed on your Reviews page); if you are a developer of the component, you can Reply to a review
  • Documentation – can include details on typical use cases, features and limitations, dependencies, installation and configuration, and frequently asked questions
    • Platform-supported components are documented in the various categories of this Marketplace Guide
    • Click Edit documentation to open a text editor where you can edit the Marketplace component’s documentation
  • Pricing – lists the pricing options (only for paid components)
  • Releases – lists all the versions of the component (any of which can be downloaded by clicking Download) along with details like the Framework version and the UUID (which can be used in the CreateNewApp operation in the Projects API):

4 My Marketplace

At the top of your Marketplace page, you can choose a category to share new Marketplace content, such as Widgets or Solutions.

The rest of this page presents previews of your Marketplace activity:

Click an item in the sidebar to go to the page for that content:

4.1 My Content

In this page, you can see the Marketplace content for which you have created at least one version. Click the context menu to access various options for managing your content:

  • View item – click this to go to the component details page
  • Create a new draft – click this to create a new draft version of the component
    • Only one draft version of a component can exist at a time, so when one draft version is in progress, another draft cannot be initiated – if there is a draft version in progress, click View draft to see it
    • For more information on creating a draft version, see the Updating Existing Marketplace Content section of How to Share Marketplace Content
  • Edit a version – click this to edit the component (for details on editing, see the Adding New Marketplace Content section of How to Share Marketplace Content)
  • Unpublish a version – click this to remove one version or all versions of the component
    • If the component is protected content from a user group, a group member can unpublish any version
    • If the component is not the protected content of a user group, you can only unpublish a version that you have published yourself
    • Select Unpublish all my versions to remove all your versions of the component

You may see the Company only label on a component, which means it is your company’s private Marketplace content (for details on how this is configured, see the Adding New Marketplace Content section of How to Share Marketplace Content). This content can be shared with guests.

In addition, you may see a label on a component name for the user group to which the component is assigned as group group content.

At the top of the page, you can click Open Drafts to see drafts of all the Marketplace content you have started:

On this page, click the name of a Marketplace component to go to its draft page, where you can continue editing the component details.

Click Delete to delete a draft. You can also click Withdraw to withdraw the content from the review process after you have submitted it for approval, which will return the content to the draft state.

4.2 Shared with Me

This page contains private content shared with you by other companies who have marked you as a guest.

4.3 Saved Content

This page presents the Marketplace content you have saved. Click the bell icon in the bottom-right corner of the component’s tile to receive email notifications on new versions of the component:

Click the context menu to access various options for managing this content:

  • View item – click this to go to the component details page
  • Receive/Stop email notifications – click this to start receivin email notifications or to stop the notifications if you already have them enabled
  • Unsave – click this to remove the component from your saved content

4.4 My Reviews

This page contains reviews of My Content by other users as well as My reviews that you have written of other content:

4.5 Company Content

On this page, you can see all the content your company has published. Click the context menu to access various options for managing this content:

The options in this menu are the same as described for the context menu for the My Content section above. However, the Edit a version and Unpublish a version options are only available for your own versions of company content.

4.6 Company Reviews

This page contains reviews of Your company’s content as well as Your company’s reviews that users from your company have written of other content.

4.7 User Groups

You can configure user groups for various levels of access to your company content. The available configuration tabs for each user group page are described in the sections below.

4.7.1 Members Tab

On this tab, you can enter the email address of a Mendix Platform user from your company and click Add Member to add them as a user group member. User group members can manage the content assigned to the group.

Once a member is added, you can select their permission level: Group Member or Group Admin. A Group Admin can manage the user group.

To remove a member, click Remove next to their name.

4.7.2 Guests Tab

A guest is a Mendix Platform user from outside your organization who can download the selected private Content of this group. To add a guest, enter their email address in the box and click Add Guest:

The guest will receive an email notifying them of access to the private content. They can then see all the private Marketplace content shared with them in their Shared with Me page.

To remove a guest, click Remove.

4.7.3 Content Tab

On this tab, you can assign content to this user group that can only be managed by members of this group. To assign a component to a user group, click Assign Content and select a company Marketplace component from the dialog box:

Click the context menu to access various options for managing this content:

The options in this menu are the same as described for the context menu for the My Content section above. The Unassign from group button is only available for Group Admins and can be used to remove content from the user group.

4.7.4 Settings Tab

On this tab, you can enter a Group Name and a Group Description.

To delete a user group, a Group Admin or Mendix Admin can click Delete Group.

4.8 Subscriptions

You can see all the Marketplace app services you have subscribed to on this page:

The table presents the Products you have subscribed to, the Type of plan status, the type of subscription Plan, and the Expiration date of the subscription.

Clicking a Product name takes you to the service management dashboard, which is described in the sections below.

4.8.1 Service Management Dashboard

This dashboard presents an overview of your service instances and binding keys. A service instance is what Mendix creates when you subscribe to an app service. After the service instance has been created, you need binding keys to use the app service in your app.

This page presents the Binding Key Names that have been created as well as details on the user who created the binding keys (Created By) and when the binding keys were created (Created At). Click Delete to delete that group of binding keys.

You can also select a group of binding keys and click Manage Instance to go to the component provider’s configuration page, where you can do further configuration.

4.8.2 Creating Binding Keys

To create binding keys for a specific subscription, click Create Binding Keys. In the dialog box, enter a name for the keys that includes the name of the app where you intend to use the component you have subscribed to (so that it is clear to other users where the keys are used).

After you click Create Keys, a page appears with your binding keys. Click Copy for each key and manually save the keys somewhere safe.

For more information, see the Using the Binding Keys section below.

Click Return to the overview to go to the main page of the dashboard.

4.8.3 Using the Binding Keys

When you are developing your app, set the app service’s binding keys as constants in the App Settings.

Refer to the documentation on specific app services for how to use the binding keys (for example, see the Authenticating MindSphere REST Calls section of MindSphere IIoT for Makers).

5 Read More