Products

Products are the fundamental building blocks of an e-shop — everything an organization sells or offers is recorded in the system as a product. The /product module therefore serves as a central catalog where all offering items are created, edited, and organized. Its goal is to provide a single place where an administrator manages not only the products themselves but also their images, variants, parameters, category assignments, and connections to other sales mechanisms such as vouchers, subscriptions, or event reservations. This breadth means that a product is not just a record with a price, but a hub connecting the entire business logic — from presentation to the customer to integration with inventory, invoicing, and product comparison engines. The page is divided into three main tabs — Products, Parameter Groups, and Parameters — which together form the parametric structure of the catalog.

Product Overview

The main page displays a table of all the organization's products. The column structure is designed to serve both content managers and those dealing with availability, pricing, or marketing attributes in daily catalog work. The view offers a product image, its name, internal code, selling price, EAN, stock availability, sales statistics, assigned categories, and a short description. Besides that, it shows the product status (active/inactive), B2B flag, visibility option in product comparison engines, "sold out" flag, and a numerical position for sorting. The table refreshes automatically every 20 seconds, so changes made elsewhere in the system (inventory updates from import, price adjustments) are reflected in the overview without manual intervention.

💡 Tip: For quick product search, use the full-text search in the top bar — it searches name, code, and EAN across all languages.

Product Lifecycle

Unlike orders, a product does not go through a linear sequence of states; instead, it has several flags that combine with each other and together determine to whom and how the product appears in the catalog. A newly created product is always in the default inactive state and without a price, so publication is a conscious step that occurs only after all necessary data has been added. This approach protects against a situation where an unfinished product might accidentally appear in the catalog before the administrator finalizes it.

• Active — the product is published in the catalog, customers can view and order it.
• Inactive — the product is hidden from customers but remains in the system and can be further edited. New units cannot be ordered from an inactive product, but older orders remain valid.
• Sold Out — the product is visible in the catalog, but the "add to cart" button is blocked. The flag is set automatically when stock drops to zero, or it can be manually turned on, for example, during a marketing pause.
• B2B — the product is displayed only to verified business customers with an active B2B account.
• Adults Only — requires age confirmation from the visitor before display.
• In Shipment Feed — determines whether the product is exported to external product comparison engines (Heureka, Google Shopping, etc.).

⚠️ Warning: Product deletion is soft — the record is not physically removed from the database. The product merely disappears from the catalog but remains preserved for historical orders, invoices, and subsequent accounting.

Creating a New Product

The Add button in the top right corner opens a form for creating a new product. The mandatory fields are the name and the language in which it is entered; the internal code and slug (part of the URL address) are calculated automatically from the name but can be manually overwritten. If you choose a custom code, the system verifies that it is unique within the organization and will refuse creation in case of a collision. After creation, the product is placed at the end of the list with an automatically assigned position, has a default inactive status, and its price and stock are not yet set — this data is completed in the product detail, where there is sufficient context and specialized editors for them.

Product Detail

Clicking on any row in the table opens the product detail, which is divided into tabs according to what needs to be addressed at that moment. The Overview tab contains the most important catalog data — name, price, code, EAN, description, and visible flags. The Gallery allows managing product images, changing their order by dragging and dropping, and with one click, designating the main image that appears as the title image. Categories serve to assign the product to one or more categories, with one always marked as the main category and used for breadcrumb navigation. Other tabs provide specialized functions. Variants manage different product versions (sizes, colors), Parameters offer technical properties assigned from a global dictionary, Related Products control the list of recommended accessories or alternatives, and Voucher Templates define vouchers that are automatically generated for the customer upon purchase of this product. Products with regular subscriptions have the Subscription Plans tab available, while tickets and calendar activities have the Events tab. The last tab is Redirects, where canonical URLs and old links are managed for SEO purposes.

Product Variants

Variants address situations where a single product is sold in several versions — typically in different sizes, colors, or materials. Each variant behaves as a separate stock keeping unit with its own code, EAN code, stock status, and potentially a different price. The variant price is entered either as a fixed price, which overrides the main product's price, or as a surcharge, where the specified amount is added to the parent product's price (often used for larger textile sizes or premium materials). A variant can also have its own main image — this is automatically displayed when the customer selects the given variant in the e-shop.

ℹ️ Information: Variants cannot be merged or converted into a standalone product. If you need to make a variant independent, use the Duplicate product action in the context menu and modify the new copy as needed.

Parameters and Parameter Groups

Parameters describe technical product properties, such as dimensions, weight, performance, or material. A key feature is their global nature — you define a parameter once for the entire organization and then assign it to any number of products. This allows customers in the catalog to filter by consistent values, and the same filter structure remains when transitioning between categories. The system works with three levels: the parameter itself represents a specific property (e.g., "Color" or "Size"), the parameter value is a predefined element from an allowed list, and the parameter group serves for logical grouping of parameters for clarity (typically "Dimensions," "Technical Specifications," "Material Composition"). A parameter can be assigned directly to a product or to an entire category — in the latter case, it is automatically offered for all products in that category.

Product Imports

Extensive catalogs are rarely maintained manually. The module therefore supports bulk creation and updating of products using XML feeds, in formats commonly used by product comparison engines. The process consists of three steps: first, the source is connected by entering the feed URL (the system then regularly downloads it), then feed fields are manually mapped to system columns (name, price, EAN, images, description) — the system automatically suggests mapping on the first load — and finally, an automatic import runs, which downloads new items and updates existing ones based on the EAN code or internal code. Products managed by a feed are labeled "feed-managed," which means that manual edits may be overwritten by values from the source during the next run. Furthermore, the system rejects invalid EAN values, does not download images immediately (they are placed in a queue and processed in the background), and newly imported products are in the default inactive state and not published in outward-facing feeds.

⚠️ Warning: After the first import, we recommend manually checking each product, adding the correct category, and only then activating it. Automatic import ensures data, but presentation quality must be approved by a human.

Contextual Menu

In the right part of each row in the table, a dropdown menu with quick actions is available, saving time during common operations. Automatic translation translates the product name and description into all configured languages for the organization where a translation is currently missing; the translation is performed asynchronously using AI, so it will appear in the catalog with a short delay. Duplicate product creates a copy including all images, categories, variants, parameters, and translations — the copy is always inactive, has its own code, and is automatically linked to the original as a related product. Edit category allows quickly changing the main category directly from the row without needing to open the detail.

Multilingual Content

Each product can have content in multiple languages simultaneously. In the detail, the language of the edited content can be switched, and the name, short description, and long description can be entered separately for each. Automatic translation is available both in the list and in the detail, and always respects the rule "do not overwrite what already exists" — it will therefore only complete missing variants without affecting completed translations. Furthermore, a separate canonical URL is created for each language, which can be edited if needed on the Redirects tab.

Parameter Groups and Parameters (Separate Tabs)

In addition to the main product overview, two separate tabs dedicated solely to the parametric structure are available at the top of the page. The Parameters tab displays a complete list of all defined parameters along with their types and allowed values, while Parameter Groups offer an organizational hierarchy for more convenient work when the organization has dozens or hundreds of parameters. Changes made on these tabs are immediately reflected in all products that use the given parameter — this makes parameters a sensitive central dictionary that should not be interfered with without careful consideration.

Statistics in Detail

In the product detail, the administrator will find summary sales indicators that help evaluate the success of individual items in the catalog. It displays the number of units sold over a chosen period, total revenue generated by the product, average price in orders (considering discounts and applied vouchers), and also the number of active variants along with stock availability. These statistics include exclusively orders in "processing" and "completed" states — cancelled orders are excluded so as not to distort the result.

💡 Tip: Use statistics to easily identify unsellable products, for which it is worthwhile to reconsider their catalog placement, add images, or adjust the price.