[InDesign Integration](https://factory.dev/our-bundles/pimcore-indesign-integration)

- [Docs](https://factory.dev/our-bundles/pimcore-indesign-integration/docs)
- [Release notes](https://factory.dev/our-bundles/pimcore-indesign-integration/releases)

[Request a demo](https://factory.dev/book-a-demo)

Get started

- [Requirements](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/requirements)
- [Before installation: access and keys](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/before-installation-access-and-keys)
- [Installation](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/installation)
- [Upgrades](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/upgrades)
- [Datahub configuration](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/datahub-configuration)
- [Create the image thumbnail for the InDesign plugin](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/create-the-image-thumbnail-for-the-indesign-plugin)
- [Licence validation](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/licence-validation)

Using the plugin

- [Open the installed plugin](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/open-the-installed-plugin)
- [Connect to Pimcore](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/connect-to-pimcore)
- [Browse objects and assets](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/browse-objects-and-assets)
- [Prepare a document and fill text frames](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/prepare-a-document-and-fill-text-frames)
- [Place images and other files](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/place-images-and-other-files)
- [Use related objects, repeated values, and galleries](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/use-related-objects-repeated-values-and-galleries)
    - Repeated related objects
    - Fill a styled table with related items
    - Galleries in text frames
- [Check for updates](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/check-for-updates)
- [Supported Pimcore data types](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/supported-pimcore-data-types)

# Use related objects, repeated values, and galleries

By Mario Prša · Updated 19 Nov 2026

## Repeated related objects

If a Product is linked to several items, put a placeholder for the related field in a text frame and use **Fill in** to insert their values in Pimcore relation order. Add `[line...]` to keep all items on one line or `[nextrow...]` to put each item on a separate row. Characters after `line` or `nextrow` and before `]` form a **delimiter between items**: for example, `[line;]` separates values with a semicolon and `[line ]` separates them with a space. The delimiter is not appended after the final item. To select just one related item, use a **1-based index** such as `[1]` for the first or `[2]` for the second.

The screenshots show the Milano Armchair Product and its BillOfMaterials relation. Its first three Material entries are Seat frame, Back frame, and Armrest assemblies; four more follow. Use the field names shown in your plugin.

| What to put in a text frame | What it produces after Fill in |
| --- | --- |
| `{Product.BillOfMaterials.Name[1]}, {Product.BillOfMaterials.Name[2]}` | `Seat frame, Back frame` |
| `{Product.BillOfMaterials.Name[line\|]}` | `Seat frame\|Back frame\|Armrest assemblies\|…\|Metal leg frame` |
| `{Product.BillOfMaterials.Name[line ]}` | `Seat frame Back frame Armrest assemblies … Metal leg frame` |
| `{Product.BillOfMaterials.Name[nextrow;]}` | Seven rows: Seat frame; / Back frame; / … / Metal leg frame (no trailing;). |

For a single repeated field, {Product.BillOfMaterials.Name\[nextrow;\]} puts the material names on separate rows; {Product.BillOfMaterials.Name\[line|\]} keeps them on one line separated by |. The delimiter is not added after the last item.

To repeat several fields of each material, put them together in one text frame and add the directive to the last field of the repeated entry. In the screenshots, MaterialID, Name, and Specification are used:

```
{Product.BillOfMaterials.MaterialID} - {Product.BillOfMaterials.Name}, {Product.BillOfMaterials.Specification[nextrow;]}
```

The filled text looks like this (with line breaks, and no semicolon after the last row):

```
1 - Seat frame, Hardwood or plywood;
2 - Back frame, Hardwood or plywood;
3 - Armrest assemblies, Padded structural core;
4 - Seat foam cushion, Upholstery foam;
5 - Back foam cushion, Upholstery foam;
6 - Leather upholstery set, Full-grain leather;
7 - Metal leg frame, Matte-black powder-coated steel
```

Use \[line|\] on the last field instead to put complete entries on one line, separated by |, as in the screenshots. Copy the actual class, relation, and attribute names from your configuration.

[![InDesign plugin — show related BillOfMaterials values with a pipe delimiter](https://factory.dev/wp-content/uploads/2026/11/fid-docs-44-indesign-plugin-show-related-billofmaterials-values-with-a-p.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-44-indesign-plugin-show-related-billofmaterials-values-with-a-p.png)

InDesign plugin — show related BillOfMaterials values with a pipe delimiter

[![InDesign plugin — prepare MaterialID, Name, and Specification placeholders](https://factory.dev/wp-content/uploads/2026/11/fid-docs-45-indesign-plugin-prepare-materialid-name-and-specification-pl.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-45-indesign-plugin-prepare-materialid-name-and-specification-pl.png)

InDesign plugin — prepare MaterialID, Name, and Specification placeholders

[![InDesign — prepare repeating material lines with the nextrow delimiter](https://factory.dev/wp-content/uploads/2026/11/fid-docs-46-indesign-prepare-repeating-material-lines-with-the-nextrow-d.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-46-indesign-prepare-repeating-material-lines-with-the-nextrow-d.png)

InDesign — prepare repeating material lines with the nextrow delimiter

[![InDesign plugin — fill the BillOfMaterials relation placeholders](https://factory.dev/wp-content/uploads/2026/11/fid-docs-47-indesign-plugin-fill-the-billofmaterials-relation-placeholde.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-47-indesign-plugin-fill-the-billofmaterials-relation-placeholde.png)

InDesign plugin — fill the BillOfMaterials relation placeholders

[![InDesign — view material lines separated by semicolons and line breaks](https://factory.dev/wp-content/uploads/2026/11/fid-docs-48-indesign-view-material-lines-separated-by-semicolons-and-lin.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-48-indesign-view-material-lines-separated-by-semicolons-and-lin.png)

InDesign — view material lines separated by semicolons and line breaks

[![InDesign — prepare indexed Material Name placeholders for three items](https://factory.dev/wp-content/uploads/2026/11/fid-docs-49-indesign-prepare-indexed-material-name-placeholders-for-thre.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-49-indesign-prepare-indexed-material-name-placeholders-for-thre.png)

InDesign — prepare indexed Material Name placeholders for three items

[![InDesign plugin — fill the first three indexed material names](https://factory.dev/wp-content/uploads/2026/11/fid-docs-50-indesign-plugin-fill-the-first-three-indexed-material-names.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-50-indesign-plugin-fill-the-first-three-indexed-material-names.png)

InDesign plugin — fill the first three indexed material names

[![InDesign plugin — inspect MaterialID, Name, and Specification on a related Material](https://factory.dev/wp-content/uploads/2026/11/fid-docs-51-indesign-plugin-inspect-materialid-name-and-specification-on.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-51-indesign-plugin-inspect-materialid-name-and-specification-on.png)

InDesign plugin — inspect MaterialID, Name, and Specification on a related Material

## Fill a styled table with related items

Use this option when a Product has related Items that you want to show in an InDesign table. Create and style the table in InDesign first: add your headings and one data row with the cell, paragraph, and character formatting you want the other data rows to use. The plugin fills your table; it does not replace it with a table imported from Pimcore.

[![InDesign — choose Table > Create Table for the bill of materials](https://factory.dev/wp-content/uploads/2026/11/fid-docs-52-indesign-choose-table-create-table-for-the-bill-of-materials.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-52-indesign-choose-table-create-table-for-the-bill-of-materials.png)

InDesign — choose Table > Create Table for the bill of materials

[![InDesign — configure a three-column table with body rows](https://factory.dev/wp-content/uploads/2026/11/fid-docs-53-indesign-configure-a-three-column-table-with-body-rows.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-53-indesign-configure-a-three-column-table-with-body-rows.png)

InDesign — configure a three-column table with body rows

[![InDesign — style the bill of materials table and its empty data row](https://factory.dev/wp-content/uploads/2026/11/fid-docs-54-indesign-style-the-bill-of-materials-table-and-its-empty-dat.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-54-indesign-style-the-bill-of-materials-table-and-its-empty-dat.png)

InDesign — style the bill of materials table and its empty data row

[![InDesign — apply the BILL OF MATERIALS header paragraph style](https://factory.dev/wp-content/uploads/2026/11/fid-docs-55-indesign-apply-the-bill-of-materials-header-paragraph-style.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-55-indesign-apply-the-bill-of-materials-header-paragraph-style.png)

InDesign — apply the BILL OF MATERIALS header paragraph style

[![InDesign plugin — copy a MaterialID placeholder into the table template row](https://factory.dev/wp-content/uploads/2026/11/fid-docs-56-indesign-plugin-copy-a-materialid-placeholder-into-the-table.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-56-indesign-plugin-copy-a-materialid-placeholder-into-the-table.png)

InDesign plugin — copy a MaterialID placeholder into the table template row

[![InDesign plugin — fill the unindexed material table row](https://factory.dev/wp-content/uploads/2026/11/fid-docs-57-indesign-plugin-fill-the-unindexed-material-table-row.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-57-indesign-plugin-fill-the-unindexed-material-table-row.png)

InDesign plugin — fill the unindexed material table row

[![InDesign — automatically generated material rows preserve the table styling](https://factory.dev/wp-content/uploads/2026/11/fid-docs-58-indesign-automatically-generated-material-rows-preserve-the.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-58-indesign-automatically-generated-material-rows-preserve-the.png)

InDesign — automatically generated material rows preserve the table styling

Place a placeholder for each Item attribute in the corresponding cell of the data row:

| Item ID | Size | Weight |
| --- | --- | --- |
| {product.Item.ID} | {product.Item.Size} | {product.Item.Weight} |

Select the Product and run Fill in. The first related Item fills the prepared row. The plugin adds one row for each remaining Item, in Pimcore relation order. Each added row inherits the formatting of the prepared data row, while the heading remains unchanged. Bulk Fill In also supports these tables: each Product’s table uses only Items related to that Product.

To fill specific Items without adding rows, prepare a row with indexed placeholders instead. For example, {product.Item.ID\[1\]}, {product.Item.Size\[1\]}, and {product.Item.Weight\[1\]} fill one row from the first related Item. A separately prepared row using \[2\] fills from the second Item. Indexes start at 1; use the same index in every cell of a row so that values from different Items are not mixed.

For example

| Item ID | Size | Weight |
| --- | --- | --- |
| {product.Item.ID\[1\]} | {product.Item.Size\[1\]} | {product.Item.Weight\[1\]} |
| {product.Item.ID\[2\]} | {product.Item.Size\[2\]} | {product.Item.Weight\[2\]} |

[![InDesign — prepare separate table rows with indexed related-item placeholders](https://factory.dev/wp-content/uploads/2026/11/fid-docs-59-indesign-prepare-separate-table-rows-with-indexed-related-it.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-59-indesign-prepare-separate-table-rows-with-indexed-related-it.png)

InDesign — prepare separate table rows with indexed related-item placeholders

[![InDesign plugin — fill indexed table rows without generating extra rows](https://factory.dev/wp-content/uploads/2026/11/fid-docs-60-indesign-plugin-fill-indexed-table-rows-without-generating-e.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-60-indesign-plugin-fill-indexed-table-rows-without-generating-e.png)

InDesign plugin — fill indexed table rows without generating extra rows

When an Item value or the Product’s Item relation changes, click Check for Updates and review the changes in UPDATES. Applying an individual update or Update All can update cell values and bring the generated rows into line with added, removed, or reordered Items. Your table styling and unrelated content remain in place. Saving and reopening the document preserves the connection needed for later updates; merely opening it does not change the table.

*Screenshot to add later: a designer-styled table with one placeholder row, followed by the filled table with several related Items.*

## Galleries in text frames

To place a specific gallery image, copy or enter an **indexed** gallery placeholder into a text frame. In the screenshots, {Product.Symbols\[2\]} places only the second symbol (the droplet icon); indices start at 1.

To place the whole gallery, use the **unindexed** placeholder `{Product.Symbols}` in a text frame and fill it. In the screenshots, the plugin places the five Symbols images in gallery order, creating adjacent frames from the placeholder position. You can move the resulting image frames to fit your design. When you later update a gallery, surviving frames keep their placement rather than returning to the original row. Review the page after adding or removing gallery images to make room for new frames as needed.

Gallery placeholders are for the text-frame workflow. To fill a single selected rectangle with an image attribute, use its **OBJECTS thumbnail** instead.

[![InDesign plugin — copy the Product Symbols gallery placeholder](https://factory.dev/wp-content/uploads/2026/11/fid-docs-61-indesign-plugin-copy-the-product-symbols-gallery-placeholder.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-61-indesign-plugin-copy-the-product-symbols-gallery-placeholder.png)

InDesign plugin — copy the Product Symbols gallery placeholder

[![InDesign — view Symbols gallery images in their original order](https://factory.dev/wp-content/uploads/2026/11/fid-docs-62-indesign-view-symbols-gallery-images-in-their-original-order.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-62-indesign-view-symbols-gallery-images-in-their-original-order.png)

InDesign — view Symbols gallery images in their original order

[![InDesign — prepare indexed placeholders for the first two Symbols](https://factory.dev/wp-content/uploads/2026/11/fid-docs-63-indesign-prepare-indexed-placeholders-for-the-first-two-symb.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-63-indesign-prepare-indexed-placeholders-for-the-first-two-symb.png)

InDesign — prepare indexed placeholders for the first two Symbols

[![InDesign — fill two indexed Symbols images in separate frames](https://factory.dev/wp-content/uploads/2026/11/fid-docs-64-indesign-fill-two-indexed-symbols-images-in-separate-frames.png)](https://factory.dev/wp-content/uploads/2026/11/fid-docs-64-indesign-fill-two-indexed-symbols-images-in-separate-frames.png)

InDesign — fill two indexed Symbols images in separate frames

[← Place images and other files](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/place-images-and-other-files) [Check for updates →](https://factory.dev/our-bundles/pimcore-indesign-integration/docs/check-for-updates)

---

Source: https://factory.dev/our-bundles/pimcore-indesign-integration/docs/use-related-objects-repeated-values-and-galleries
