Skip to main content

3. Marketplace: Products

The Products page in Marketplace is your central catalog for defining and managing the items available for customers to purchase. Each product can be scoped to a specific Project, assigned to one or more Categories, priced, and localized with rich content and SEO metadata.

Finding “Products” in Marketplace

Open the left-hand navigation menu.

Scroll down to Marketplace and click its chevron to expand.

Click Products under the Marketplace section.

That will take you to the Products page where you can view, add, filter, and manage your catalog.

Table View

Total (top-left): Shows the number of products in your current view (here: 3).

Filter (funnel icon): Opens a side-panel with advanced filters (see Filtering & Searching below).

Search: Instant, real-time search across product names and subtitles.

Columns

Column Description
Products Thumbnail, Name link (e.g. “teast”), and subtitle below (e.g. “Teast”).
Reference Custom SKU or reference code (or “–” if none).
Project The Project the product belongs to (or “–” for global).
Category Primary Category label (e.g. “Test”).
Price ⇅ Numeric price in your currency. Click header to sort ascending/descending.
Status ⇅ Active (green) or Inactive (gray) badge. Click header to sort.
Actions ✏️ Edit opens the Edit form; 🗑️ Delete permanently removes the product (with confirm).

+ Add (top-right): Opens the “Add product” form (see below).

Filtering & Searching

Click Filter to open these options:

  • Name – Free-text search on the product name.

  • SKU – Free-text search on SKU/reference.

  • Reference – Dropdown of existing reference codes.

  • Categories – Multi-select categories.

  • Price – Numeric range (min/max).

  • Show only – Checkboxes for Active or Inactive.

After choosing criteria, click Save to apply filters (the Total count updates accordingly).

Adding a Product

Open the Form: Click + Add in the Products table header.

General Section

  • Project – (Required) Select the Project context.
  • Name – (Required) Enter the product name.
  • Categories – Pick one or more categories for discovery.
  • Reference – (Optional) Select or type a reference/SKU.
  • SKU – (Optional) Enter your own SKU.
  • Price – (Required) Numeric price.
  • Active – Toggle on to make the product live.

Images

  • Main image – Drag-drop or browse to upload a primary photo (jpg/png).
  • Main external image – Paste a URL to load an off-site image.
  • Additional images – Upload multiple supporting photos.
  • Additional external images – Paste URLs for extra photos.

Properties: JSON editor for custom key/value attributes (e.g., color, weight).

Save: Click Save to create the product. It immediately appears in the table.

Editing a Product

Click ✏️ in the Actions column to open the Edit panel, which has two tabs:

A. General Tab

Identical to the Add form, but pre-populated. You can:

  • Change Project, Name, Categories, Reference, SKU, Price, Active state.

  • Update or replace images.

  • Modify JSON Properties.

B. Contents Tab

This tab manages translations, page content, and SEO metadata:

  • Languages – Select the target language badge (Ar, En, Es, Zh, etc.).
  • Title – Localized product title for the storefront.
  • Subtitle – Short tagline or description.
  • Page meta title – SEO title tag.
  • Page meta description – SEO meta description tag.
  • Properties – JSON editor for any locale-specific attributes.
  • Text – Rich-text editor for detailed product description, features, specs.
  • Clone translation from: Opens a modal to select a source language; copies its fields into the current language.
  • Translate: Invokes an integrated translation service (e.g., OpenAI) to auto-translate all fields into the current language.
  • Save: Click Save (bottom-left) to apply edits in both tabs.
Deleting a Product

Click 🗑️ in the Actions column. A confirmation tooltip appears:

Are you sure? [Cancel] [Delete]

  • Delete – Permanently removes the product.

  • Cancel – Closes the tooltip without action.

Audit Logging: Every deletion registers the product name, user, and timestamp in the system audit log.

Tips & Best Practices

  • Batch Edits: When adding many products, prepare a JSON file for Properties to paste into the editor.

  • Consistent Categories: Use the same category labels to keep your catalog organized.

  • SEO Optimization: Always fill in Page meta title and description to improve search ranking.

  • Use Clone & Translate: Leverage “Clone translation from” to avoid retyping common fields, then tweak details per locale.

  • Review Filters First: If a newly saved product doesn’t appear, check your active filters or search terms.

With these tools, the Marketplace Products module becomes a powerful, project-scoped catalog manager—fully searchable, sortable, localized, and audit-ready.

Back to top