Brands
Product version: 1.0.0+1 Last updated: 2026-08-03 Audience: Tenant users with
product:brand:read(create/update/delete use matchingproduct:brand:*)
A. What Are Brands?
A Brand represents a label or product line that products in your catalog are associated with. Brands help identify the commercial label of a product.
Examples: - "Nike" — athletic footwear and apparel - "Apple" — consumer electronics - "Acme" — a fictional product line
A brand can optionally include a website URL and a logo image for visual identification. Brands are tenant-scoped — each organization manages its own brand list.
Note: The manufacturer (maker / vendor) is a separate catalog entity. Do not confuse brand with manufacturer. A brand can be Active or Inactive. Inactive brands remain in the system but do not appear in selection dropdowns for new products.
B. Viewing the Brand List
- Go to Product Catalog > Brands from the side navigation rail.
- The brand list shows all brands in your tenant, paginated at 20 per page.
- Each row displays:
| Column | Description |
|---|---|
| Name | Brand name (opens the brand form) |
| Status | Active (green pill) or Inactive (gray pill) |
| Products | Count of products assigned to this brand |
| Website | Brand website URL |
| Updated | Last modification timestamp |
Use the search bar to find a brand by name. Use the Status filter to show only active or inactive brands.
C. Creating a Brand
Required permission:
product:brand:create
- Go to Product Catalog > Brands.
- Click Add Brand (the "+" button).
- Fill in the form fields:
| Field | Required | Description |
|---|---|---|
| Name | Yes | Brand name (max 100 characters) |
| Description | No | Plain text description of the brand |
| Website | No | Full URL to the brand's website (e.g., https://example.com) |
| Logo URL | No | URL to the brand's logo image. Use the media picker to upload, or paste an external URL |
| Active | No | Toggle ON (default) to make the brand available immediately |
- Click Save.
The brand appears in the brand list and becomes available in the product creation/edit form's Brand dropdown.
Tip: Use a square logo image (at least 400×400 pixels) for best display in catalog views.
D. Editing a Brand
Required permission:
product:brand:update
- From the brand list, open a brand (row / Edit) to open the brand form.
- Modify the fields:
| Field | Editable |
|---|---|
| Name | Yes |
| Description | Yes |
| Website | Yes |
| Logo URL | Yes |
| Active | Yes |
- Click Save.
Note: Setting a brand to Inactive does not affect existing products assigned to it. It only hides the brand from selection dropdowns for new or edited products.
E. Brand Form (create / edit)
Opening a brand from the list (or Add Brand) opens the brand form — there is no separate brand “detail” page with an embedded products table in the current app.
The form covers:
- Name, description, website, logo (media picker when permitted)
- Active / inactive
- Save / delete actions (permission-dependent)
Record metadata (ids, audit timestamps) may appear when editing an existing brand, depending on the form layout.
F. Products Associated with a Brand
A brand can have many products. The association is set when creating or editing a product — the Brand field in the product form (or setup wizard) links the product to the brand.
Finding products for a brand
- Open Product Catalog > Products.
- Filter by Brand.
- Open any product to view or change its brand on the product form.
Removing a brand from a product
- Open the product's edit form.
- Clear the Brand field (empty / no brand).
- Save.
The product is now unassociated from the brand. The brand itself is not affected.
Note: Deleting a brand is a soft delete. Products may retain the previous brand id until updated. Prefer setting the brand to Inactive if you may need it again.
Previous: Items Next: Categories
Related: Overview · Products · Variations · Variation Options
See also: Tenant Owner Manual · Employee Manual