---
title: "Add a product and manage its versions"
description: "Find products in the register, add a product in one of three ways, and create, release, withdraw or delete its versions."
url: https://helpcenter.complytrain.net/en/articles/175-add-a-product-and-manage-its-versions
collection: "Products and versions"
updated: 2026-09-22
language: en
---

# Add a product and manage its versions

Find products in the register, add a product in one of three ways, and create, release, withdraw or delete its versions.

Find products in the register, add a product in one of three ways, and create, release, withdraw or delete its versions.

A product is the thing your organisation makes or supplies. A version is one configuration of it, such as 1.0, Rev C or Block II. Identifiers, specifications, parts, test results and export determinations all belong to a version, so every product starts with one. This topic follows one example, the Northstar temperature monitor, from the register to its second version.

## Who can do this

Product location: `/products`. Open Products and choose Product register.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Task</p></th><th colspan="1" rowspan="1"><p>Permission</p></th></tr><tr><td colspan="1" rowspan="1"><p>Open the register and read products</p></td><td colspan="1" rowspan="1"><p><strong>View Products</strong> (<code>product-library:view</code>)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Add a product, create a version or delete a draft version</p></td><td colspan="1" rowspan="1"><p><strong>Manage Products</strong> (<code>product-library:manage</code>)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Release or withdraw a version</p></td><td colspan="1" rowspan="1"><p><strong>Change Product Lifecycle State</strong> (<code>product-library:manage-lifecycle</code>)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Add or remove identifiers</p></td><td colspan="1" rowspan="1"><p><strong>Manage Product Identifiers</strong> (<code>product-library:manage-identifiers</code>)</p></td></tr></tbody></table>

Admins can do all of these. Buttons appear only for people who can use them. A product or version classified above your clearance does not appear for you at all; see [classifications and clearances](https://help.complytrain.net/en/product-library/clearances/).

## Find a product

Product location: `/products`. Open Products and choose Product register.

Open **Products** and choose **Product register**. The register lists your organisation's products in product-number order, 25 to a page.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Control</p></th><th colspan="1" rowspan="1"><p>What it does</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Search</strong></p></td><td colspan="1" rowspan="1"><p>Finds products whose name, product number or any identifier value contains the text you type, for example a customer part number. Partial words work and upper and lower case are treated alike. Press Enter or choose <strong>Apply</strong>.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Profile</strong></p></td><td colspan="1" rowspan="1"><p><strong>All profiles</strong>, or only the products that use one profile. The list includes every profile your products use, including profiles that have been retired from the catalogue.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Status</p></td><td colspan="1" rowspan="1"><p>Active products, obsolete products or both. It shows active products unless you choose otherwise, so choose obsolete to find a product your organisation no longer offers.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Top-level products only</strong></p></td><td colspan="1" rowspan="1"><p>Hides products that sit under a parent product.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Apply</strong> and <strong>Clear</strong></p></td><td colspan="1" rowspan="1"><p><strong>Apply</strong> runs the filters. <strong>Clear</strong> appears once you have set a filter and returns to the starting view.</p></td></tr></tbody></table>

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Column</p></th><th colspan="1" rowspan="1"><p>What it shows</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Number</strong></p></td><td colspan="1" rowspan="1"><p>The automatic product number, for example PRD-2026-0001.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Name</strong></p></td><td colspan="1" rowspan="1"><p>The product's name.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Status</p></td><td colspan="1" rowspan="1"><p>Whether the product is active or obsolete.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Profile</strong></p></td><td colspan="1" rowspan="1"><p>The product's profile, or a dash when it has none.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>In service</strong></p></td><td colspan="1" rowspan="1"><p>A badge such as "On 3 market(s)" when the product is placed on markets. Otherwise the label of the version in service, or <strong>None yet</strong>.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Versions</strong></p></td><td colspan="1" rowspan="1"><p>How many versions the product has.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Classification</strong></p></td><td colspan="1" rowspan="1"><p>The product's classification level, or a dash.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Parent</strong></p></td><td colspan="1" rowspan="1"><p>The product it sits under, or a dash.</p></td></tr></tbody></table>

Select a row, or move to it and press Enter, to open the product. **Previous** and **Next** move between pages. The line "Showing 1–25 of 60" counts only products you are cleared to see.

When nothing matches, the page says **No products match those filters**; choose **Clear**. Above the table, **Found in your material** lists products the assistant found in your documents that are not yet in the register; see [discover products](https://help.complytrain.net/en/product-library/discover-products/).

## Choose how to start

Product location: `/products/new`. In the Product register, choose New product.

1.  In the register, choose **New product**. The **New Product** page asks **How would you like to add this product?**
    
2.  Choose one of the cards.
    
3.  To change your mind, choose **Back** on the next step.
    

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Card</p></th><th colspan="1" rowspan="1"><p>Use it when</p></th><th colspan="1" rowspan="1"><p>What happens after the product is created</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Upload a document</strong></p></td><td colspan="1" rowspan="1"><p>You have a datasheet, drawing or test report.</p></td><td colspan="1" rowspan="1"><p>The files go into the product's own document vault, are read and indexed, and the assistant drafts specifications from them.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Fill in manually</strong></p></td><td colspan="1" rowspan="1"><p>You will record everything yourself.</p></td><td colspan="1" rowspan="1"><p>The product page opens.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Describe to AI</strong></p></td><td colspan="1" rowspan="1"><p>You can describe the product in a few sentences.</p></td><td colspan="1" rowspan="1"><p>Your description is saved on the product, and the assistant drafts specifications from it.</p></td></tr></tbody></table>

The two AI cards appear only when your organisation has the specification assistant set up. Without it, the page offers **Fill in manually** and explains that an administrator can enable the assistant.

![Start with a document upload, manual entry or an AI description.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/SDq2Ghyc0Fxrsi3hOifRzmzikLOJGZDpCJvdExuXJoabWIKWeyrQUgfBT7oxQr1idjwr1FnzSNf.png "Choose how to create the product")

## Fill in the details

Product location: `/products/new`. In the Product register, choose New product, then choose one of the cards.

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>Required</p></th><th colspan="1" rowspan="1"><p>What it does</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Name</strong></p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>The name shown in the register and in every module that refers to the product. Up to 255 characters. You can change it later.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Profile</strong></p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>The kind of product. It decides the lifecycle states, identifier schemes and export control regimes. The first profile in the list is preselected. It cannot be changed after the product is created, so read <a target="_blank" rel="noopener noreferrer nofollow" class="linktype-link link" data-linktype="link" href="https://help.complytrain.net/en/product-library/product-profiles/">product profiles</a> first. When no profile is available, the wizard says so; an Admin makes a profile available, as described in <a target="_blank" rel="noopener noreferrer nofollow" class="linktype-link link" data-linktype="link" href="https://help.complytrain.net/en/product-library/product-profiles/">product profiles</a>.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>First version</strong></p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="1" rowspan="1"><p>The label of the first version. The default is 1.0, and a blank field also gives 1.0. Up to 60 characters.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Describe the product</strong></p></td><td colspan="1" rowspan="1"><p>With <strong>Describe to AI</strong></p></td><td colspan="1" rowspan="1"><p>Your own description, in any format. It is kept as the product's description. Up to 10,000 characters.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Product documents</strong></p></td><td colspan="1" rowspan="1"><p>With <strong>Upload a document</strong></p></td><td colspan="1" rowspan="1"><p>At least one file. Drag files onto the area, or click it to browse. PDF, Word, text, Markdown, RTF, PNG and JPEG files are accepted; other files are skipped and the page says so. <strong>Remove</strong> takes a file off the list.</p></td></tr></tbody></table>

Choose **Create product**, **Create and read documents** or **Create and draft with AI**, depending on the card. The button reads **Working…** while it runs. If something is missing, the page says what, for example "Enter a name for the product." **Cancel** returns to the register without creating anything.

The product receives the next product number, for example PRD-2026-0014. Numbering restarts at 0001 each year, and a number is never reused. The first version is created at the same time, as a draft in the profile's first lifecycle state.

![The example uses the General product profile and first version 1.0. The profile choice becomes fixed after creation.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/fFwHfVxowrrXzO1tgKNu66yVcXl7NVU98yxn2ulZvnYrTAkvnsTMdlC2zKfkX4NCulrM1FPLx2I.png "Enter the product and configuration")

## What the AI modes do

Product location: `/products/new`. In the Product register, choose New product, then choose Upload a document or Describe to AI.

With **Upload a document**, after the product is created the wizard shows each stage as it happens:

1.  **Preparing this product’s document vault…** creates the product's own vault, named after the product number and name.
    
2.  **Uploading your documents…** stores each file in that vault.
    
3.  **Reading and indexing your documents…** waits while the files are read, for up to five minutes. Large or scanned files take longest.
    
4.  The product page opens with the **Read a specification** assistant, which already knows which files you uploaded.
    

The files are stored only in this product's vault and are not shared with other products. You can open the vault from the product's **Connected** tab; see [connected records](https://help.complytrain.net/en/product-library/connected-records/). If the upload or the reading does not complete, the wizard tells you that the product was created and takes you to it. The documents finish reading on their own; open the assistant from the **Specifications** tab once they are ready.

With **Describe to AI**, the product page opens with the same assistant. It reads your description, drafts the specifications it can infer and asks about anything it could not.

The assistant only proposes. Every value it drafts waits under **Specifications read from documents** until someone accepts it; see [record and review specifications](https://help.complytrain.net/en/product-library/review-specifications/). Using the assistant needs **Manage Products**.

## Check the new product

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register.

The product page opens on **Overview**. The header shows the name with badges for the product number, the profile and any classification. Below it, the **Versions** card lists each version with its status, and **New version** adds another. The tabs are **Overview**, **Specifications**, **Markets**, **Bill of materials**, **Qualification**, **Claims**, **Export control**, **Connected** and **History**.

A product with nothing recorded yet shows **Getting this product on its feet**, with the shortcuts **Record what it is** (Specifications), **Say where it is sold** (Markets) and **Record what qualifies it** (Qualification). The card disappears once the selected version has identifiers, the product has markets, or work is waiting for your review.

The page also shows the product's description, status, owner, regulatory contact and parent product. To change them, see [maintain a product record](https://help.complytrain.net/en/product-library/maintain-product/).

![The first configuration is marked Draft. Its version state and profile lifecycle controls are shown separately.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/eUnlJfTG3sA3gwg2AzLezikOm5M7O50GdCa6GgMSPKprNyGcfwoFYXwaSfvuBHLQiaXQK1z5aJV.png "The saved draft configuration")

## Versions and their status

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register. Select a version in the Versions card.

Select a version in the **Versions** card to work on it. The page opens on the version in service, or on the newest version when none is in service. Most tabs show the selected version; **Markets** and **Claims** cover the whole product.

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Badge</p></th><th colspan="1" rowspan="1"><p>Meaning</p></th><th colspan="1" rowspan="1"><p>What you can do</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Draft</strong></p></td><td colspan="1" rowspan="1"><p>Still being defined. Its label, identifiers and parts list can change.</p></td><td colspan="1" rowspan="1"><p>Release it or delete it.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>In service</strong></p></td><td colspan="1" rowspan="1"><p>Released. What it is made of is locked.</p></td><td colspan="1" rowspan="1"><p>Withdraw it. Keep adding specifications, results, claims, markets and export determinations.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Superseded</strong></p></td><td colspan="1" rowspan="1"><p>A later version was released and took over. It stays readable.</p></td><td colspan="1" rowspan="1"><p>Withdraw it.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Withdrawn</strong></p></td><td colspan="1" rowspan="1"><p>Taken out of service, with a recorded reason.</p></td><td colspan="1" rowspan="1"><p>Read it.</p></td></tr></tbody></table>

When the selected version is not a draft, a lock notice such as "1.0 is locked" explains that its configuration can no longer change and that you create a new version to change it.

The status is separate from the version's lifecycle state, which the profile defines and which decides whether the version can be offered commercially. See [move versions through their lifecycle](https://help.complytrain.net/en/product-library/lifecycle-history/).

## Where identifiers live

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register. Select a draft version in the Versions card and find the Identifiers card.

Identifiers, such as a manufacturer part number, belong to a version rather than to the product, because a model number or GTIN can change between configurations. Add them in the **Identifiers** card on **Overview** while the version is a draft: choose a **Scheme**, enter the **Value** and choose **Add**. Release locks them.

A new version starts with no identifiers; it can repeat an earlier version's values, such as the same part number. The register's **Search** finds a product by an identifier on any of its versions. Schemes, formats, uniqueness and the one-value-per-scheme rule are covered in [record identifiers and related products](https://help.complytrain.net/en/product-library/identifiers-relations/).

![Manufacturer part number NST-124 survives reloading. The profile determines the available schemes and uniqueness rules.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/pX7Pmd1FqOPEuxVYKOfjuqkpnxFqU9turzPCBgJZjRLdvHRWQSAukNROIWbnyYfRHT5knlLo4sg.png "Confirm the identifier")

## Release a version

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register. Select the draft version in the Versions card.

Releasing records that this configuration is fixed. Units delivered under it stay traceable to exactly what they were built as.

1.  In **Versions**, select the draft version.
    
2.  Check its identifiers on **Overview** and its parts on **Bill of materials**. They cannot change after release.
    
3.  Choose **Release this version** on the **This version** card.
    
4.  A confirmation states that the version's label, identifiers and parts list will be frozen. Confirm to release, or cancel.
    

A released version cannot return to draft. The badge changes to **In service** and the **Released** date appears. **Release this version** is offered only for products with a profile. The release is refused until the version has an identifier for every scheme the profile requires; required schemes are marked with an asterisk on the **Profiles** page.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Locked at release</p></th><th colspan="1" rowspan="1"><p>Still open after release</p></th></tr><tr><td colspan="1" rowspan="1"><p>The version label</p></td><td colspan="1" rowspan="1"><p>Specifications</p></td></tr><tr><td colspan="1" rowspan="1"><p>Identifiers</p></td><td colspan="1" rowspan="1"><p>Test results and qualification</p></td></tr><tr><td colspan="1" rowspan="1"><p>The bill of materials</p></td><td colspan="1" rowspan="1"><p>Claims</p></td></tr><tr><td colspan="1" rowspan="1"><p>The record of which version it supersedes</p></td><td colspan="1" rowspan="1"><p>Market placements and authorizations</p></td></tr><tr><td colspan="1" rowspan="1"><p></p></td><td colspan="1" rowspan="1"><p>Export determinations and lifecycle moves</p></td></tr></tbody></table>

What happens to the version that was in service depends on markets:

-   If the product has no market placements, the earlier version becomes **Superseded**, and a **Supersedes** relationship is recorded under **Related products** on **Overview**.
    
-   If the product has market placements, including planned ones, both versions stay **In service**, because each market can be on a different version. A market moves to the new version when you place the new version on it, and the earlier version's placement there is withdrawn with a reason that names the new version. To take the earlier version out of service everywhere, withdraw it. See [markets and authorizations](https://help.complytrain.net/en/product-library/markets-tests-claims/).
    

Release does not change the lifecycle state. Under the General product profile, a released version stays in the Draft state, which cannot be offered commercially, until someone moves it; see [the General profile example](https://help.complytrain.net/en/product-library/lifecycle-history/#the-general-profile-example). A draft cannot be moved into a marketable state at all, so release comes first.

Other modules are asked what the release affects. A tender that bids the earlier version, or a course that is re-issued when the product changes, appears as a proposal under **What this change affects** on **Bill of materials**; see [review what a change affects](https://help.complytrain.net/en/product-library/connections-change-impact/).

![Version 1.0 now has an In service badge. The separate profile lifecycle remains Draft.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/UKmaC1RlmYLHtNi9CTNyoCb2pJOxiUzV5YBFy70ev2uF1bUnOj1lew1j26RAr046kKkeRbN1DjE.png "Release the selected configuration")

## Create the next version

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register. Choose New version in the Versions card.

For example, the Northstar monitor's version 1.0 is in service, and engineering adds failover monitoring as version 1.1.

1.  In the **Versions** card, choose **New version**.
    
2.  Complete the fields and choose **Create version**, or **Cancel**.
    

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>Required</p></th><th colspan="1" rowspan="1"><p>What it does</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Version</strong></p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>The label, for example 1.1, Block II or Rev C. Up to 60 characters. It must be unique within the product; a label already used is refused with a message saying so.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>What changed</strong></p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="1" rowspan="1"><p>A short description, for example "Adds failover monitoring". It is the first thing anyone reviewing the version reads, and it appears on the <strong>This version</strong> card.</p></td></tr></tbody></table>

The new version is a draft in the profile's first lifecycle state, and it is selected. It starts empty: identifiers, parts and specifications are not copied from earlier versions, so record what applies to this configuration. The earlier version keeps everything recorded against it.

![Version 1.1 records a failover-monitoring change while the earlier version remains available.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/JVOQA5oZfxh9JBhRPAJ00kRF8vyUvA2nUuT5vmgd7dKHHnhPXa4E67l7rpIQDkmb6bIVPuolq7B.png "Describe the next configuration")![The version list retains 1.0 In service and 1.1 Draft after reloading; 1.0 is selected in this screenshot.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/HM7xb5TlPCetMO5r1qOUKMX0HJt80bw4FFh3ttls3PdbQNu75mt3k05WagNjbvrLJ4QGmVQsGUV.png "Keep both configurations traceable")

## Withdraw a version

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register. Select the version in the Versions card.

Withdraw a version that is **In service** or **Superseded** when it is taken out of service, for example because a safety notice replaces it in the field.

1.  Select the version and choose **Withdraw** on the **This version** card.
    
2.  Enter **Why is this being withdrawn?** This is required, is kept permanently and is the first thing an auditor asks about. Up to 4,000 characters.
    
3.  Choose **Withdraw version**, or **Cancel**.
    

The badge changes to **Withdrawn** and the **Reason for withdrawal** shows on the **This version** card. Withdrawing cannot be undone. It does not change the version's market placements, which you withdraw on **Markets**, or its lifecycle state. Other modules are told, as they are for a release.

## Delete a draft version

Product location: `/products/{productId}/overview` (fallback: `/products`). Open the product from the Product register. Select the draft version in the Versions card.

A draft that was created by mistake and never released can be deleted, together with everything recorded only against it.

1.  Select the draft version and choose **Delete draft** on the **This version** card.
    
2.  The dialog **Delete this draft version?** first lists how many records of each kind will go with it: parts, specifications, test results, planned market placements, draft claims, proposed export determinations and relationships.
    
3.  Choose **Delete**, or **Cancel**.
    

The version and those records are removed in one step, along with its identifiers and lifecycle history. The version disappears from the **Versions** card and the page selects another version.

Deletion is refused, with a message saying why, while a tender bids the draft. A version that has been released cannot be deleted; withdraw it instead.
