# How to Create a New Module/Package in the Marketplace

## Prerequisites

We assume you have all prerequisites you may need, including:

1. If needed: the VPN is configured to access the Finmars resources
2. If needed: access to the Virtual Machine to work with the sensitive information
3. Must have: registered in Finmars in the needed region environment (self-registered or registered by Finmars)
4. Must have: having permissions set to allow continue with the Action in the Guide
5. Must have: registered in Finmars Marketplace to use credentials to push a module/package

## Creating a New Module/Package in the Marketplace

**Step 1.** Add a new module or package by navigating to **Configuration > Configuration > Manage**. Once there, click the **"Add New Configuration"** button in the top right corner, as shown in the picture below.

[![Untitled3.png](https://docs.finmars.com/uploads/images/gallery/2025-01/scaled-1680-/untitled3.png)](https://docs.finmars.com/uploads/images/gallery/2025-01/untitled3.png)

Picture 1. Finmars manage configuration

**Step 2**: After clicking the "**Add New Configuration**" button, a new window will appear where it's needed to fill in the required fields.

 See the example below:

- **Configuration Code**: Enter the configuration code for your module. Follow the configuration pattern that is shown.
- **Name**: Enter the desired module name.
- **Version**: Add the version.
- **Status**: Choose between "Stable" or "Release Candidate."
- **Category**: Select from "General," "UI," "Pricing," or "Workflow." Choose "General" if unsure.

\*\*\* The 'I**s Primary**' checkbox indicates the primary configuration. When this option is enabled, user fields or other related entities should be retrieved from the primary configuration.

Modules are installable components on the Finmars platform that enhance its functionalities. A Package is a set of modules that will be installed in ordered sequence. To create a package, check the "**Is Package**" checkbox. If it’s a module, leave it empty.

When clicking button "**CREATE**". The manifest will be created.

[![Untitled4.png](https://docs.finmars.com/uploads/images/gallery/2025-01/scaled-1680-/untitled4.png)](https://docs.finmars.com/uploads/images/gallery/2025-01/untitled4.png)

Picture 2. Finmars configuration manager

**Step 3**: To verify if your module has been created, go to the manage configurations and check if your package/module is created.

[![Untitled6.png](https://docs.finmars.com/uploads/images/gallery/2025-02/scaled-1680-/untitled6.png)](https://docs.finmars.com/uploads/images/gallery/2025-02/untitled6.png)

Picture 3. Locally created module

**Step 4:** Before pushing newly created module/package you need to make sure that the administrator of the Finmars Marketplace has created the same module/package in the Finmars Marketplace, otherwise you will have error pushing the module/package.

For the administrator of the Finmars Marketplace to correctly create a new module/package:

1. Open the newly created module/package in the the manage configurations page
2. Creating the module also generates the manifest JSON file. Copy that manifest JSON.
3. Sent it to the administrator of the Finmars Marketplace

[![image.png](https://docs.finmars.com/uploads/images/gallery/2025-02/scaled-1680-/qCFimage.png)](https://docs.finmars.com/uploads/images/gallery/2025-02/qCFimage.png)

Picture 4. Manifest of the created module

**Step 5:** If you are the administrator of the Finmars Marketplace

1. Request/receive from the module/package creator the Manifest content/ For example like: ```json
    {
        "configuration_code": "com.finmars.request-entities",
        "date": "2025-01-28",
        "dependencies": [],
        "description": "Temporarily module for workflows",
        "name": "Finmars request entities",
        "version": "1.0.1"
    }
    ```
2. Go to [https://marketplace.finmars.com/admin/](https://marketplace.finmars.com/admin/) and login with your credentials
3. Go to [https://marketplace.finmars.com/admin/marketplace/configuration/](https://marketplace.finmars.com/admin/marketplace/configuration/) and make sure that this configuration hasn't been already created (search)
4. If the configuration hasn't been created click on the "**Add Configuration +**" button in the right upper corner: [![image.png](https://docs.finmars.com/uploads/images/gallery/2025-02/scaled-1680-/GzCimage.png)](https://docs.finmars.com/uploads/images/gallery/2025-02/GzCimage.png)
5. Fill in all the needed information from the Manifest (it's a must to have the same info in the Configuration Code) and click on "**Save**" button: [![image.png](https://docs.finmars.com/uploads/images/gallery/2025-02/scaled-1680-/dBFimage.png)](https://docs.finmars.com/uploads/images/gallery/2025-02/dBFimage.png)

**Step 6:** [How to Push a Module/Package to the Marketplace and updating version](https://docs.finmars.com/books/configurator-quick-start/page/how-to-push-a-modulepackage-to-the-marketplace-and-updating-version "How to Push a Module/Package to the Marketplace and updating version")