Docs / FlowCRM AI
Signup

Marketplace

Install and manage addons such as AI Reports, AI Writer, Automations, and future workspace modules.

Estimated reading: 5 minutes

Marketplace - Main Features Overview

The Marketplace helps administrators browse product catalog items, buy compatible packages, install packages, review installed package status, and keep FlowCRM AI extensions updated from one admin workspace.

Unlike older add-on manager layouts, the Marketplace is organized around two primary areas: Product catalog for discovery and purchase, and Packages for installed package operations.

Marketplace Dashboard

Open Admin > Marketplace to view the main Marketplace workspace.

Summary Cards

The top summary gives admins a quick health check of the marketplace system.

  • Installed packages: total packages currently tracked by Marketplace.
  • Active packages: packages currently booted through the marketplace provider bootstrap file.
  • Catalog products: products currently available in the synced product catalog.
  • Featured products: highlighted releases promoted in the catalog.

Top Actions

  • Install: opens the install package modal.
  • Packages: opens the installed packages manager.
  • Cart: opens the marketplace cart when storefront checkout is configured.

Product Catalog

The Product catalog section is where admins browse compatible products and modules. It supports catalog search, category filtering, featured filtering, product type filtering, and product cards with purchase or install status actions.

Catalog Filters

  • Search: search by product name, module name, or category.
  • All categories: filter products by synced category.
  • Featured only: show only products highlighted by the marketplace.
  • Main only: show main product packages.
  • Addons only: show extension packages.
  • Clear: reset catalog filters.

Product Cards

Each product card can show product icon, name, version, module type, short description, detail link, demo link, purchase actions, install status, or update action.

Common actions include:

  • Detail: open the product detail page.
  • Demo: open the product demo if provided.
  • Add Regular: add a regular license to the cart.
  • Add Extended: add an extended license to the cart.
  • Buy on Envato: open the Envato purchase page for Envato-based products.
  • Update: update an installed marketplace product when a newer version is available.
  • Installed: confirms the product is already installed and current.

Buying Marketplace Products

Marketplace products can be purchased through the connected storefront cart or through an external Envato purchase link, depending on how the product is configured.

Storefront Cart Purchase

  1. Open Admin > Marketplace.
  2. Find the product in Product catalog.
  3. Click Add Regular or Add Extended.
  4. Open the cart icon in the top action bar.
  5. Review subtotal, discount, total, and cart items.
  6. Click Buy now to continue checkout in the connected storefront.

The cart supports item quantity display, subtotal, discount, total, remove item, clear cart, and buy-now handoff to the shop application when configured.

Envato Purchase

If a product is configured as an Envato product, the product card may show Buy on Envato. After purchase, use the Envato purchase code in the Install modal.

Installing Packages

Click Install on the Marketplace page to open the Install package modal. The modal supports two installation methods.

Install With Purchase Code

  1. Open Admin > Marketplace.
  2. Click Install.
  3. Select Purchase code.
  4. Enter the Envato purchase code.
  5. Click Install package.

The system verifies the purchase code with the marketplace API, downloads the package, installs it into the correct location, saves license metadata, and activates the package.

Install With ZIP File

  1. Open Admin > Marketplace.
  2. Click Install.
  3. Select ZIP file.
  4. Upload the module ZIP package.
  5. Click Install package.

The ZIP must extract into a module folder and include module.json at the root of that folder. Manual ZIP installation is intended for module packages, not for reinstalling the main script.

Packages Page

Click Packages to open the installed package manager. This page focuses on packages already present in the application.

Package Filters

  • Search installed packages: search by package name, module name, or version.
  • Status: filter by All, Active, or Inactive.
  • Clear: reset package filters.

Package Table

The package table displays package title, module name, source, active state, description, current version, and update status.

Source types:

  • Marketplace: installed using a purchase code and eligible for remote marketplace updates.
  • Manual: installed from a ZIP package.
  • Directory: detected from a local module directory.

Package metadata can include:

  • Product ID.
  • Masked purchase license.
  • Licensed domain.
  • Module name.
  • Current installed version.
  • Active or inactive state.

Updating Packages

Marketplace purchase packages can show Upgrade version when a newer remote version is available. ZIP and local directory packages show No remote update because they are not tied to a marketplace purchase update flow.

  1. Open Marketplace > Packages.
  2. Find the package that shows Upgrade version.
  3. Back up database and files before updating production.
  4. Click Upgrade version.
  5. Wait for the update to finish.
  6. Reload Marketplace and confirm the package version changed.

Rescan Packages

The Rescan action on the Packages page scans installed modules and refreshes Marketplace tracking records. Use it after copying a module into the application manually or after resolving package metadata problems.

Uninstalling Packages

Packages can be removed from the Marketplace package manager when they are no longer needed. Before uninstalling, confirm the package is not required by active workflows, dashboards, clients, projects, approvals, deliverables, billing features, AI tools, reports, or automations.

Before uninstalling:

  • Back up files and database.
  • Check whether the package provides active routes, providers, migrations, permissions, or UI pages.
  • Confirm no customer workflow depends on it.
  • Test the app after uninstalling.

Best Practices

  • Use the Product catalog to discover and purchase packages.
  • Use Packages to operate installed packages.
  • Install from purchase code when possible so the package can receive marketplace updates.
  • Use ZIP installation only for trusted module packages.
  • Back up before installing, upgrading, or uninstalling production packages.
  • Update the main FlowCRM AI package before extension packages.
  • Clear caches and test major workflows after package changes.
  • Confirm sidebar buttons, plan permissions, and pricing rows are hidden when a related addon is not installed.

Troubleshooting

Catalog products do not load
Check marketplace API configuration and server internet access. The Marketplace can still manage installed packages, but the remote catalog may be unavailable until the source is reachable.

Install with purchase code fails
Confirm the purchase code is correct, the domain is licensed, and the marketplace install API is configured.

ZIP install fails
Confirm the ZIP contains a valid module folder and module.json. Also check write permission for the modules directory.

Upgrade version does not appear
Confirm the package source is Marketplace, product ID and purchase code are present, and the marketplace catalog can load the latest product version.

Addon menu does not appear
Confirm the module folder exists, the provider is registered, routes are loaded, and the current plan includes the required addon permissions.