Installing from the Catalogue

Your panel has a built-in catalogue of ready-made plugins and themes that it can install for you in a couple of clicks. This is the normal way to add a payment gateway, an infrastructure integration or a notification channel without building one yourself and without handling a package file. This article covers where the catalogue is, how to find something in it, what happens when you install it, and how to keep installed items up to date or take them off again.

Where it is

Open Settings from the admin sidebar, then the Integrations group, then the Marketplace entry. The page opens on two tabs:

• Browse — everything available to install.
• Installed — the items you already have, and their updates.

Anyone on your team who can open Settings can reach it. The catalogue's contents are maintained centrally rather than by your company — you install from the list, you do not add entries to it.

The Browse tab

Browse shows a grid of cards, twelve to a page, with pagination underneath when there are more. When you have not typed a search, up to three highlighted items appear above the grid in a wider Featured strip; they behave exactly like any other card. Start searching and the featured strip steps out of the way.

Narrowing the list

Three controls sit in a row above the grid.

Browse controls

Control	What it does
Search (Search marketplace…)	Filters the grid as you type and returns you to page one. It matches on the item's name, its one-line summary and its full description.
Type	All Types (the default), Plugins, or Themes. Plugins add behaviour — a gateway, a provider integration, a notification channel. Themes change how the panels look.
Sort	Most Popular (the default), Newest, Price: Low to High, Price: High to Low, or Top Rated.

If nothing matches, the grid is replaced by a No listings found panel suggesting you adjust your search or filters. Clear the search box and set the type back to All Types to get the full list back.

What a card shows

Each card carries, from the top:

• a banner image, and the item's icon — a puzzle-piece placeholder for a plugin, a palette for a theme, when the item has no icon of its own;
• its name, with the item type underneath;
• a one-line summary, or the opening of its description;
• its price — either Free, or an amount marked excl. VAT, with /mo after it if the item is charged monthly;
• its star rating and the number of ratings, when it has been rated;
• the number of installs, where that figure is published, and the latest version number.

Prices are shown in your own currency where a conversion is available, so the figure on the card is the figure you will be asked to pay.

Opening an item

Click anywhere on a card to open its full listing in a panel over the page. The top of the panel shows the banner, the item's name and its one-line summary, and a row of badges: the item type, its category, its star rating, its version, and how many installs it has.

The left side of the panel has tabs:

• Description — the full write-up of what the item does. This is where you find out whether it fits your setup, so read it before installing.
• Screenshots — only present when the item has any. Click one to open it full size and step through the rest with the arrows.
• Reviews — the average rating with a breakdown by star, and the written feedback left by other companies. Once you have obtained the item you can add a rating and a short comment of your own from here.

The right side has the price card with the action button, and an Information panel listing the item's type, its category, its version and the date it was created, plus any tags underneath.

Installing an item

Everything happens through the single button on the price card. What it says depends on the item and on what you already have.

The action button on a listing

Button	Meaning
Get for Free	The item costs nothing. One click obtains and installs it in a single step.
Purchase amount	The item is paid. Clicking it opens a payment step; the amount shown excludes VAT.
Install Now	You already hold this item but it is not installed here — for example after you removed it. One click installs it again with nothing further to pay.
Installing… / Processing…	The step is running. Leave the panel open until it finishes.
Installed	A green marker, not a button. The item is already installed on this panel, so there is nothing to do here.

A free item

1. Open the listing and read the Description tab.
2. Click Get for Free.
3. The item is fetched and installed in one step. A confirmation appears reading Plugin “name” installed and ready to use, or Theme “name”…, and the price card switches to Installed.

A paid item

1. Click Purchase with the amount on it.
2. A checkout panel opens showing the subtotal, the VAT added on top, and the total. Depending on how payments are handled for the catalogue, you either complete the payment inside that panel or are sent to the payment provider's own page and returned afterwards.
3. As soon as the payment succeeds the item installs itself — the button moves to Installing… on its own. You do not need to come back and install it manually.
4. An item priced with /mo is a recurring charge, not a one-off. The listing says Billed monthly under the price.

Note: If nobody has finished setting up payments for the catalogue on your installation, a paid item reports that the payment gateway is not configured and no charge is attempted. Free items are unaffected.

What happens during installation

The item is downloaded and imported into your own panel. From that moment it is yours locally — it runs on your installation, against your own configuration.

• A plugin is imported and switched on automatically. This is the one difference from importing a plugin from a file, which always arrives as a draft for you to review and enable by hand. If the automatic enable does not take, the plugin is still installed and you can enable it yourself from the Plugins page.
• A theme is added but not applied. It arrives switched off, so nothing about your panels changes until you activate it deliberately.

If the installation itself fails, the message reads Installation failed. You can retry from your installed items. Nothing is charged twice — reopen the listing and the button now reads Install Now.

Where the item appears afterwards

Where to go next once an item is installed

Item	Where it turns up	What to do there
Any plugin	Settings → Integrations → Plugins	Open it and fill in its configuration — API keys, account identifiers, endpoints. Nothing that came from the catalogue carries anybody's credentials, so every secret has to be entered by you. See Managing Plugins and Configuration Settings.
A payment gateway plugin	Settings → Financial → Payment Gateways	It appears as its own card alongside the built-in gateways, with a switch to turn it on and a configuration button. See Payment Gateways.
A theme	Settings → Appearance → Themes	Preview it and activate it when you are ready. See Themes.

Tip: Install a payment gateway or a provider integration outside your busiest hours and test it end to end before you point live customers at it. An installed plugin is switched on immediately, but it does nothing useful until its configuration is complete.

The Installed tab

The second tab lists every plugin and theme on this panel that came from the catalogue, newest install first. Items you built yourself or imported from a file are not listed here — they live on the Plugins and Themes pages.

Each row shows the item's icon, its name, and underneath: the item type, the installed version, its current state, and the date it was installed. The state is the plugin's own — enabled, draft or disabled — or, for a theme, active or inactive.

With nothing installed, the tab shows No marketplace items installed and points you back to Browse.

Updating an item

1. Click Check for Updates at the top right. The panel compares every installed item against the latest published version.
2. You are told either that All items are up to date, or how many updates were found. Rows with a newer version available gain a blue badge showing that version number, and a short summary of what changed appears under the name.
3. Click Update to vx.y.z on the row. The button reports Updating… while it works and the version number on the row moves up when it is done.
4. Rows that were already current show an Up to date marker after a check.

Updating a plugin brings in the new version's flows, forms, webhooks, styling and configuration fields, and keeps the configuration and secrets you already entered, so it carries on working without you re-entering keys. Updating a theme replaces its styling with the new version's.

Tip: Check for updates before you troubleshoot an integration that has stopped behaving. A provider changing its API is one of the more common reasons an item needs a newer version.

The Suspended badge

A red Suspended badge on a row means the item is no longer validly held by your company — a monthly item whose payment has lapsed is the usual reason. The item is switched off rather than deleted, so none of its configuration is lost, and it is switched back on by itself once it is valid again. The check runs each time you open the tab.

Removing an item

There is no remove button on the Installed tab. You take an item off from the page where it lives:

• A plugin — go to Settings → Integrations → Plugins, open the menu on the plugin's card and choose Delete, then confirm.
• A theme — go to Settings → Appearance → Themes and use Delete on the theme, then confirm.

Deleting removes the item and its local configuration from your panel; it disappears from the Installed tab. Your entitlement to it is not affected — reopen its listing under Browse and the button reads Install Now, so you can put it back without paying again.

Warning: Deleting a plugin deletes the configuration and the secrets you entered into it. Anything that depends on it — a gateway your customers are paying through, a provider integration that services are provisioned on — stops working immediately. Switch a plugin to disabled first and satisfy yourself that nothing broke, and only then delete it.

The catalogue versus a package file

Installing from the catalogue is one of two ways to get a plugin onto your panel. The other is importing a package file that somebody gave you, or that you exported from another installation of your own.

Choosing between the two

	From the catalogue	From a package file
How you get it	Browse, then one click	You are given a file and upload it
State on arrival	Enabled straight away	Draft, for you to review and enable
Updates	Check for Updates on the Installed tab	You are sent a new file and import it over the top
Listed under Installed	Yes	No

Everything else is the same: in both cases the item runs on your own installation, no secrets travel with it, and you enter your own credentials afterwards. For the file route, including what a package does and does not contain, see Packaging, Importing & Updating. For day-to-day work with plugins once they are installed, see Managing Plugins; for what a plugin is made of, see Introduction to Plugins.

Related pages

Managing Plugins · Packaging, Importing & Updating · Introduction to Plugins · Payment Gateways · Themes · Settings