Skip to main content

5. Marketplace: Configurations

The Configurations page in Marketplace is where you define project-scoped settings—most commonly, status lists (e.g., Order statuses, Transaction statuses). Each project gets its own set of items, but you can “clone” the entire list from another project to save setup time.

1. Navigating to Configurations

Open the side menu (☰) → MarketplaceConfigurations.

The page header reads Configurations.

2. Project Scoping

At the top you’ll see Settings by project:

  • Search: Filter the list of projects by name.

  • Project tags: Each pill represents a project. Click one to load its configuration items.

3. Viewing Configuration Categories

Below the project selector you’ll see one or more cards, each for a different category. For example:

Order statuses
(If none exist yet) “No data to display”

4. Cloning from Another Project

Click Clone from project.

In the modal, pick the source project whose items you want to copy.

Click Clone.

All statuses from that project instantly appear in your current project’s list.

5. Adding a New Configuration Item

Click + Add on the category card.

Fill in the Add … panel fields:

  • Project: (pre-selected) the target project.
  • Name: Internal key (e.g. pending).
  • Label: What users will see (e.g. Pending).
  • Color picker: Choose the badge color for quick recognition.
  • Make as default: Sets this status as the default when new orders are created.
  • Final: Marks this status as a terminal (can’t transition onward).

Click Save to create the new status.

6. Editing & Deleting Items

Once a status exists, use the ✏️ Edit icon to change its Name, Label, Color, or flags, and the 🗑️ Delete icon to remove it.

7. Best Practices
  • Clone an existing project’s statuses to keep workflows consistent.

  • Use Default sparingly—only one status should be the entry point.

  • Mark Final statuses (e.g. Completed, Cancelled) so downstream logic can trigger correctly.

  • Review and prune unused statuses to avoid clutter.

By combining project‐scoped lists, easy cloning, and a simple add/edit/delete workflow, the Configurations module ensures that each project’s unique needs are met while minimizing repetitive setup.