New product

Create a single product step by step: information, category, attributes, images, price, variants, and sales channel decisions are sent to PIM in a single record.

The New product screen is a wizard where you manually add a single product to PIM step by step. You enter the product name, type, and codes, select its categories; then define its attributes, images, price, variants if any, and sales channel status. All information is sent to PIM at once in the final step. This screen is used by catalog teams who manually create a small number of products.

Accessing the screen

Follow the menu path PIM & Catalog › Catalog › New product. If you do not see it in the menu, your account does not have permission for this screen. The screen requires product creation permission: if you see and open it in the menu but are redirected to the permission page, your account can view products but cannot create them.

Screen sections

  • Title: New product with the description "Creates the product step by step; the record is sent to PIM at once. Draft is stored in this browser." If you have entered anything, a Start over button appears at the top right.
  • Step rail (left): lists the wizard steps in order. Under each step, a brief summary of entered information is shown (e.g., "2 categories", "5/12 filled", "3 images", "4 channel decisions"). Completed steps show a green checkmark.
  • Step area (right): step number, name, short hint, and form.
  • Navigation buttons: below the form are Back and Next; on the last step, Next is replaced by Create product.

If selection lists fail to load, an error "Selection lists could not be loaded" and a Retry button appear.

Steps and product type

The number of steps depends on the selected Product type:

Product type Steps
Non-variant product types (e.g., single product) Product info › Attributes › Images › Price › Sale state › Confirm (6 steps)
Variant product Product info › Attributes › Images › Price › Variant definitions › Variant products › Sale state › Confirm (8 steps)

When the type is selected, the path you will follow is shown below the field: for single product "Single product: SKU and barcode are required in this step.", for variant product "Variant product: variant steps open, SKU/barcode entered in variants."

Navigating between steps

  • The Next button validates the current step. If there are missing fields, you cannot proceed; a notification titled "There are missing fields in this step" lists the missing fields (e.g., "Product name · Model · At least one category") and Required field warnings appear under missing fields. Required field warnings only appear after pressing Next; the "code already used in PIM" warning appears immediately while typing.
  • The Back button returns to the previous step; it is disabled on the first step.
  • You can click a step in the step rail to jump directly to it, but only if all previous steps are complete. Steps not yet accessible appear disabled.
  • In variant products, if no axes are defined, the Variant products step is skipped and the rail shows "Skipped (no axis)".

Draft and Start over

Everything you enter, including uploaded image names, is saved as a draft in this browser. When you reload the page or close and reopen the tab, the wizard resumes where you left off and a "Incomplete draft restored." notification appears at the top.

  • The draft is stored only in this browser; it does not appear on another computer or in a private window.
  • Start over (in the title or notification bar) clears the draft without confirmation and resets the wizard to the first step with default selections. This action cannot be undone.
  • When submission receives a response and the result screen opens, the draft is deleted, even if the result is Save did not complete. If submission ends with an error without any response, the draft is preserved.

Step 1 · Product info

Enter the product's identity information and categories.

Field Required Description / rule
Product name Yes The product's name. Written to the Content list selected in the Sale state step.
Product type Yes Lists product types defined in the system; variant type cannot be selected (variants are created inside variant products).
Model Yes The product's model code.
Option code Yes The product's option code. Must be unique in PIM. Images are uploaded to this code's folder.
SKU Yes for single product Visible only for single products. Must be unique.
Barcode Yes for single product Visible only for single products. Must be unique.
Category tree Yes The tree from which categories are selected. The first tree is selected by default. Changing the tree clears selected categories.
Categories At least one Selected via Pick categories button.

Code uniqueness

When you leave the Option code, SKU, or Barcode fields, the system checks shortly whether the value is already used in PIM. One of the following messages appears under the field:

Message Meaning
Checking… Validation in progress.
Available Code is free; a green checkmark also appears.
This option code is already used in PIM (similar message for SKU and barcode) Code exists on another product. You cannot proceed with Next without changing it; the missing list shows "Code in use".
Uniqueness could not be checked; PIM will check again on save. Validation could not be performed at this time. You may proceed; code will be rechecked on save.

Selecting categories

  1. Ensure the Category tree is selected (button is disabled if not).
  2. Click the Pick categories button. If categories are already selected, the button changes to Change categories.
  3. In the popup, expand/collapse the tree or use the Search box to find categories by name, path fragment, or full category code. Search opens parent categories and highlights matches.
  4. Click a row to select a category; click again to deselect. Selected rows show a Selected badge and the category ID in the right column.
  5. Click Apply N categories to confirm. Cancel closes without applying.

Selected categories are listed below the field as full paths with a Remove icon to delete individually. If none are selected, the message "No category selected yet — Attribute sets come from selected categories." appears.

Tip: Attributes to be filled in the next step come from attribute sets linked to selected categories. Selecting the correct category ensures all required attributes appear.

Step 2 · Attributes

Attributes from the attribute sets of selected categories are listed as a form; you can also add attributes manually that are not in the sets.

Sections

  • Attribute list (required): list where attribute values are entered. The first list is selected by default.
  • Filter: All (n), Empty (n), Required (n). Use to focus on empty or required fields in long forms.
  • Attribute fields: a value selector for each attribute. Required attributes have a * next to their name.
  • Attribute sets card (right): each set from categories and its attributes. Attributes with values show a green checkmark; empty required attributes show a red circle. The badge at the card header shows filled/total attributes; it turns yellow if required attributes remain empty, green if all filled.

Rules for sets:

  • If the same attribute appears in multiple sets, it shows as a single field; if required in any set, it is required.
  • If a default value is defined in the set, the field is prefilled.
  • If you go back and change categories, entered values and manually added attributes are preserved; only the set list refreshes.
  • Attributes from sets cannot be removed from the form. If left empty, they are not sent to the product (if not required).
  • Only attributes with entered values are saved.

Pressing Next with empty required attributes shows a warning "N required attributes are empty." above the form.

Selecting values

  1. Click the attribute's box (Pick a value).
  2. Select a value from the list or type in the Search or type a new value box to filter.
  3. If the desired value is not in the list, click "…" use as new value. The box shows a New badge; the value is added to the attribute when saving the product.
  4. Press Enter: if the typed text exactly matches a value or only one result remains, it selects it; otherwise, it treats the text as a new value.

The list shows up to 200 values ("N more values — narrow search"). You can clear the selected value with Clear.

Editing values and attributes

Next to each value selector are small buttons:

  • Edit value: opens the full form of the selected value (translations, validity dates, settings). Disabled if no value selected.
  • New value: opens the form to define a new value for the attribute. Saved value is written to the field.
  • Edit attribute: opens the attribute definition and settings window. Changes affect the attribute itself and all products using it.
  • Remove (trash): visible only for manually added attributes.

See Attributes — details for form field details.

Adding attributes

  1. Click the Add attribute button below the form.
  2. Type the name in the Search attribute box and select from the list. Attributes already added to the product do not appear; the list shows up to 300 results.
  3. If the attribute does not exist, create it with the New attribute button in the popup; the saved attribute is added directly to the product.

If no attribute sets exist for the categories, the message "No attribute set in these categories" appears; you can add attributes manually with Add attribute. If sets cannot be loaded, an error "Attribute sets could not be loaded" and a Retry button appear.

Step 3 · Images

Upload product images and videos. This step is optional; you can proceed without images and add them later in product details.

Field Required Description / rule
Asset list If uploading images The first list is selected by default. After the first image is uploaded, the list cannot be changed: "List cannot be changed after images are uploaded (files are in that list's directory)."

Upload steps:

  1. Ensure you entered Option code in step 1. If not, a warning "Images are uploaded to the option code directory; enter option code in step 1 first." appears and the upload area is locked.
  2. Drag files to the Drag or choose images or videos area or click to select. Multiple files can be selected. Image files and MP4/WebM videos are accepted.
  3. Files upload sequentially; during upload, "Uploading… N files left" is shown. If a file fails, others continue and a "N files failed to upload" notification shows which files failed and why.

Uploaded files appear as thumbnails:

  • The first image is the main image and has the Main badge; others show their order number.
  • Change order by dragging a card over another or using Move left / Move right buttons.
  • Remove deletes the image from the draft.

Note: Files are sent to storage immediately upon upload, before product creation; only names are stored in the draft, so they are not lost if you refresh the page.

Step 4 · Price

Field Required Description / rule
Price list Yes The price list where the price is entered. Default is the first list.
Currency Yes Default TRY (if defined), otherwise the first currency.
List price No If entered, must be greater than zero. "Optional; discount rate is shown based on this."
Sale price Yes Must be greater than zero. If lower than list price, discount rate appears below (e.g., "%20 discount").
Price valid from No Date and time.
Price valid to No Cannot be before valid from: "End date cannot be before start date."
  • You can use comma or dot as decimal separator.
  • If amount is invalid, a warning "Enter an amount greater than zero" appears.
  • If sale price is higher than list price, a warning "Sale price is higher than list price." appears; this does not block progress, only alerts.

Variant definitions (variant products only)

Visible only for variant products. Select the axes (e.g., size, color) on which variants differ and the values for each axis. All combinations of axis values become separate variants.

Field Required Description / rule
Variant attribute list If axes exist List where variant attribute values are entered. Default is the first attribute list.
N. axis For each added axis Only attributes of type Variant can be selected. An attribute can be used on only one axis.
Axis values At least one per axis When an axis attribute is selected, a value list opens below it.

Steps:

  1. Click Add axis and select an axis attribute. You can add up to 4 axes; after the fourth, the button disappears. If no Variant type attributes exist in setup, the button is disabled with the note "No Variant type attribute in setup."
  2. Check the boxes for desired values in the axis value list. Use the search box to filter, Select visible (n) to select all visible values, and Unselect visible to clear selection. You can add a value not in the list with "…" use as new value.
  3. The badge at top right shows how many variants will be created (e.g., "12 variants will be created").
  4. You can delete an axis with the trash icon (Remove). Changing the axis attribute resets its value selections.

Selected values are ordered by the value list order, not by click order; variants are created in this order.

If no axis is added, a warning "If no axis is added, the product is saved as non-variant and the Variant products step is skipped." appears and Next takes you directly to the Sale state step.

Variant products (variant products only)

A row is created for each combination of axis values; enter SKU and barcode for each row.

Column Meaning
# Row number.
Axis columns The value of each axis for this variant (e.g., Size: M, Color: Black).
SKU * Variant SKU. Required.
Barcode * Variant barcode. Required.
Sale price Optional variant price; if entered, must be greater than zero.
List price Optional variant list price; if entered, must be greater than zero.

If the price box is left empty, no price is written for that variant.

Conveniences above the table:

  • Suggest empty SKUs: suggests SKUs for rows with empty SKU using option code and axis values in the format <option code>-<value>-<value>, replacing spaces and slashes with dashes. Does not modify filled SKUs.
  • Paste SKUs / Paste barcodes: allows pasting a list copied from Excel or similar, one value per line, filling the table in order; empty rows skip that variant. Use Apply N rows to write values to the table.
  • Apply main price to all: writes the sale and list price entered in step 4 to all variants (overwrites previously entered variant prices). Disabled if no sale price entered.

Cell warnings:

Warning Meaning
Required SKU or barcode is empty (shown after pressing Next).
Duplicate in table The same code appears in multiple rows. Case insensitive.
Already in PIM Code exists on another product. A warning "N variant codes are already used in PIM." also appears above the table.

Codes are batch-validated shortly after typing stops; during validation "Checking…" is shown at top right, then the number of rows.

Tip: If you go back and change axis values, the table is rebuilt. SKU, barcode, and prices of unchanged combinations are preserved; new combinations are empty.

Sale state

Determine whether the product is open or closed for sale on sales channels and which list and language the content is written to.

Sales channels

For each channel, a group of three options appears with the channel name and code:

Option Meaning
— No decision. No sale state is sent for this channel.
Open for sale Product is recorded as open for sale on this channel.
Close for sale Product is recorded as closed for sale on this channel.

Open all, Close all, and Clear buttons set all channels at once. For variant products, "In variant products, decision applies to all variants." is shown. If no sales channels are defined, "No sales channels defined" appears.

Other fields

Field Required Description / rule
Content list Yes "Product name and sale state are written to this list." Default is the first list.
Language Yes Language for the content. Default is the first language.
Publish date No Date and time.
Expiry date No Cannot be before publish date.

Confirm

Review everything you entered on a single page before submitting.

  • Summary cards: Product info, Attributes (only those with values), Images (count), Price, for variant products Variant products (variant count and axes), and Sale state (channels open for sale have green badges, closed have red). Each section has an Edit button that takes you to that step.
  • Payload to be sent: technical view of the data sent to PIM; useful when troubleshooting with support.
  • Right card: shows how many records will be created ("N product records will be created (main product + variants)."), Company selection (required, default first company), and how the record will be processed:
    • Single record (non-variant product or variant product without axes): "Single record is processed immediately in PIM; result appears on this screen."
    • Multiple records (variant product with defined variants): "Multiple records are queued; result is in transaction detail."

Creating the product

  1. Review the summary and select the Company.
  2. Click Create product. The button shows "Saving…" and disables during submission. Disabled if no Company is selected.
  3. All steps are revalidated immediately before submission. If a step is incomplete or submission fails, a Product could not be saved notification with error details appears; your draft is preserved. Open the relevant step with Edit, fix, and retry.

Result screen

After submission completes, the wizard is replaced by a result card:

Title Meaning
Product created Record was processed immediately and product created.
Saved to the queue Records (e.g., variants) were queued for processing; monitor result in transaction detail.
Save did not complete One or more records failed. The card lists the field and error message in red. You cannot return to the wizard from this screen; start over with Create similar below.

Below the title, the number of records sent ("N records sent") and a PIM status badge appear; if PIM returns a message, it is shown in a warning bar. The card has these buttons:

  • Open product: goes to product details if the product was created immediately.
  • Transaction detail: opens the transaction log for this submission; queued records' results can be monitored here. The transaction number is also shown at the bottom of the card.
  • Create similar: starts a new product with the same category, attributes, price, variant axes, and channel selections. Name, model, option code, SKU, barcode, images, and variant codes are cleared; the wizard opens at the first step. Saves time when creating products in the same family consecutively.
  • New product: restarts the wizard completely empty.

Common situations

  • Result was "Save did not complete" and I cannot go back to fix. The draft is deleted when the result screen opens. Create similar preserves category, attributes, price, variant axes, and channel selections; re-enter product name, model, option code, SKU, barcode, images, and variant codes. Remember to fix the field indicated in the error row.

  • I pressed "Next" but it does not proceed. There are missing or invalid fields in the step. The notification lists missing fields; fix fields with red borders. If a code is already used in PIM, "Code in use" appears in the missing list.

  • Image upload area is not clickable. You did not enter Option code in step 1 or Asset list is not selected. Enter option code and return to this step.

  • Cannot change image list. The list locks after the first image is uploaded. To upload to another list, remove images from the draft with Remove; the list becomes selectable again.

  • Attributes step is empty. No attribute set exists for the selected categories. Ensure correct categories are selected or add attributes manually with Add attribute. Attribute sets are defined in the Attribute sets screen.

  • I created a variant product but there is no "Open product" button. Multiple records are queued for processing; the product is not created immediately, so no product link appears on the result screen. Monitor the result with Transaction detail; when processing completes, find the product in the Products list.

Related screens