---
title: "Action: Related products"
description: "Imports relations between products (for example accessories or replacements) into Sapera. Rows are matched on product identifier together with related product identifier. Run Compare first to preview the changes."
url: https://support.sapera.io/en/articles/591-action-related-products
collection: "SyncTool"
updated: 2026-09-25
language: en
alternates: [da]
---

# Action: Related products

Imports relations between products (for example accessories or replacements) into Sapera. Rows are matched on product identifier together with related product identifier. Run Compare first to preview the changes.

Imports relations between products (for example accessories or replacements) into Sapera. Rows are matched on product identifier together with related product identifier. Run Compare first to preview the changes.

## How to use the action

1\. Select the action in the **Action** field. 2. Point to your data source – a **file** (CSV or Excel) or a **SQL query**. 3. Map the source columns to Sapera's fields in the column mapping (see _Source fields_ below). 4. Run **Compare** to see what will be created, changed or stay unchanged – without writing to Sapera. 5. Run **Update Sapera** to perform the import.

Use the **Allow create** and **Allow update** parameters to control whether new rows are created and whether existing ones are updated.

## How matching and updating works

Each relation is given as **product + related product** (ProductIdentifier + the related product's number). The action sets the relations on the product.

-   Both products must already exist. Direction: from file/SQL into Sapera.
    

## Key parameters

<table data-id="eef10a14-f1c4-4a99-9379-ed47c5856236" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="54372160-e705-475b-859e-2bbbb3dc32b8" style="text-align: left;"><strong>Parameter</strong></p></td><td colspan="1" rowspan="1"><p data-id="2136ad84-eb71-4db6-baf2-117d1920852a" style="text-align: left;"><strong>Explanation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a1386f66-a2f7-4644-af49-44fb90e412c1" style="text-align: left;">AllowCreate</p></td><td colspan="1" rowspan="1"><p data-id="8e114962-c309-4cda-8a61-0f1237741009" style="text-align: left;">When enabled, product relations that do not yet exist are created.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4ac28d11-8d78-463a-9415-cf4b7f067ca3" style="text-align: left;">AllowUpdate</p></td><td colspan="1" rowspan="1"><p data-id="29c65075-9304-4701-8b83-814a7e15c821" style="text-align: left;">When enabled, existing product relations are updated.</p></td></tr></tbody></table>

## Source fields

<table data-id="00ad12e0-05a3-420c-bd96-1af782a094a5" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="10d0382f-0e3d-4bc3-9abf-883aa4facbab" style="text-align: left;"><strong>Field</strong></p></td><td colspan="1" rowspan="1"><p data-id="f5602e22-4852-48d4-a994-2a72cce7d021" style="text-align: left;"><strong>Explanation</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="71aad668-577c-40fb-aae3-0674ad4e67f1" style="text-align: left;">AddAutomatically</p></td><td colspan="1" rowspan="1"><p data-id="c6e4e76a-8b02-41e3-a18d-975c939fe4cf" style="text-align: left;">Whether the related product is added automatically with the main product.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="a82e25f3-2c25-49c3-8b6e-2c01267f4652" style="text-align: left;">Price</p></td><td colspan="1" rowspan="1"><p data-id="2aeb3a9b-2a56-47bd-a84d-53dab0b17076" style="text-align: left;">Fixed price for the related product when added through the relation.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="7dd33f7f-ecc1-42d3-8337-33b3fb028d5c" style="text-align: left;">PricePercent</p></td><td colspan="1" rowspan="1"><p data-id="8336e45b-6f74-460a-b4e4-702e52a48b18" style="text-align: left;">Price for the related product as a percentage of its normal price.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="4b390fb0-253c-4d90-aac4-88192f3da93b" style="text-align: left;">ProductIdentifier</p></td><td colspan="1" rowspan="1"><p data-id="1f04a9fa-e092-47c4-a559-66f24fc6be9d" style="text-align: left;">Identifier of the product that owns the relation.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="269f6cda-305f-4dcc-9c2b-1caf13c3e8bf" style="text-align: left;">Quantity</p></td><td colspan="1" rowspan="1"><p data-id="c0b4d354-bce9-4f2f-aecf-8b45e1602837" style="text-align: left;">Quantity of the related product added through the relation.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="3a971735-6e0f-44fa-a819-20df77864d01" style="text-align: left;">RelatedProductIdentifier</p></td><td colspan="1" rowspan="1"><p data-id="0e11fd54-a0c5-4ab3-85b1-8f7f4b429f91" style="text-align: left;">Identifier of the related product.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="9f87b901-256b-4a4a-a64e-c22729eaa246" style="text-align: left;">RelationTypeSystemNane</p></td><td colspan="1" rowspan="1"><p data-id="40284202-ec37-4dc0-87d1-37eeb625d934" style="text-align: left;">System name of the relation type that classifies the relationship.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="d325cc24-d5fb-4850-a877-6fb1a0af1c5b" style="text-align: left;">ShouldBePrinted</p></td><td colspan="1" rowspan="1"><p data-id="f7c80e37-33af-4cf1-a899-cc40da1fac52" style="text-align: left;">Whether the related product is printed on the receipt.</p></td></tr></tbody></table>

* * *

See also the overview [SyncTool – actions](https://support.sapera.io/en/articles/547-synctool-handlinger.md).

* * *

**Want to know more?**

Read more in these related articles:

[

Standard parameters for all actions

The general parameters available on most SyncTool actions: step control, error handling, timeout, etc.

](https://support.sapera.io/en/articles/648.md)
