In this article, you will learn
- where to find the VDP Editor in the Workflow,
- how to open and close the VDP Editor,
- how the user interface of the VDP Editor is displayed and
- how a created VDP order is displayed in the user interface of the Workflow.
1. Introduction
In the Workflow, variable elements are applied to a Print Item via the tab Variable Data within the Print Item View of an Article or a Print Item inside an Order or Production Job.
Tab Variable Data
Up to version 1.13.0, variable data could also be assigned using the tab Variable Data in the Adobe Illustrator plug-in.
In the Workflow, the VDP Editor is a browser-based application that was first made accessible to the user in version 1.12.0. It can be accessed via the tab Variable Data in the Print Item View of an Article or a Print Item inside an Order or Production Job.
The following description refers to the user interface of the VDP Editor. The editor allows variable data or elements to be placed directly in the browser and to enrich them with data from a CSV file – without the need to open the Print Item in Adobe Illustrator beforehand.
Figure 1: The tab Variable Data in the Workflow, which serves as the starting point for creating variable data
To open the VDP Editor, proceed as follows:
- Open the desired Article or a Print Item of an Order or Production Job.
- Activate the tab Variable Data [1].
- Open the VDP Editor by clicking the VDP Editor [2] button. Optionally, you can upload the desired control file beforehand by clicking Add CSV File [3] in the tab. If you do not do this in advance, you can still add, delete, or replace a CSV file at any time directly within the VDP Editor.
- The VDP Editor will then open in the browser. Please note that for larger images, loading may take some time, as all required resources must be processed first.
Figure 2: The default view of the VDP Editor in the browser
The user interface of the VDP Editor consists of the following elements:
- Menu Bar [4] – displays information and provides functions for saving, closing, viewing warnings, accessing VDP Editor settings, dimming the static part of a VDP Job, and displaying the Trim and Bleed area.
- Ruler [5] – vertical and horizontal rulers shown in the system´s configured unit of measurement.
- Toolbar [6] – contains the tools required for creating and editing variable elements.
- Artboard [7] – the working area used to place objects and display the Print Item, including the Image Box [8] – the final visible format – and the Bleed [9], which should not contain any variable elements.
- Settings Area [11] – provides functionalities and displays relevant information, organized into four tabs [10].
2. Elements of the User Interface
The user interface of the VDP Editor follows a familiar structure already known to the user from the Impose Editor and the general navigation within the Workflow. In addition to the menu bar and toolbar, it features an artboard and predefined settings areas for parameterizing the variable elements. The following overview explains these components. Detailed instructions on how to create and configure specific variable elements such as Serial numbers, Variable Barcodes or QR Codes, Variable Objects, and Variable Images are provided in the respective articles. Important considerations when creating and editing variable elements can be found in the article Creating and Editing Variable Objects.
2.1. Menu Bar
Figure 3: The menu bar of the VDP Editor
The menu bar of the VDP Editor provides the following information and functions from left to right:
- Print Item or Article Name [12] – displays the name of the underlying Print Item to which variable elements are being applied. Please note, that the name shown in the Print Item or Article Name can differ from the actual file name.
- Save [13] – saves the current VDP specification, which includes the position, shape, and content of all variable elements.
- Close [14] – closes the VDP Editor without saving the current VDP specification.
-
Edit [15] – contains editing functions for copying and pasting VDP elements. The dropdown menu provides the following options:
- Cut (ctrl +X or cmd +X) – cuts the selected VDP element and places it in the clipboard.
- Copy (ctrl +C or cmd +C) – copies the selected VDP element to the clipboard.
- Paste (ctrl + V or cmd +V) – inserts the clipboard content into the center of the Print Item.
- Paste in Original Position (ctrl + shift + V or cmd + shift + V) – pastes the clipboard contents in its original position on the Print Item.
- Warning Triangle [16] – displays warnings and errors encountered within the VDP Editor. Warning and error messages help validate VDP Jobs by notifying the user of potential problems that could cause errors in the output.
- Help [17] – displays available keyboard shortcuts for working efficiently in the VDP Editor.
- VDP Editor Settings [18] – offers configuration options for customizing the editor´s behavior, ensuring smoother operation.
- Dim Static Content [19] – when activated, dims all static elements according to the specified opacity setting in the VDP Editor Settings, helping the user to focus on the variable content. The icon turns green when the function is active.
- ImageBox [20] – displays the ImageBox (final visible area) when the icon is yellow, allowing the user to verify if variable elements are placed too close to or beyond the TrimBox [8] (in Figure 2). When the icon is gray, the ImageBox is hidden.
- ImageBox + Bleed [21] – displays the Bleed area [9] (in Figure 2) when the icon is turquoise. This allows users to quickly identify whether there is enough Bleed in the Print Item or whether a Bleed should be created first using a Fixup. When the icon is gray, the Bleed area is not displayed.
- Transparency Grid [22] – toogles a checkerboard pattern to indicate transparent areas in the Print Item. This allows users to determine whether a variable element can be placed in the background and still remain visible.
- Zoom Level [23] – displays the current zoom level. A dropdown menu offers a selection of predefined zoom settings.
2.2. Tool Bar
The VDP Editor also includes a set of tools that can be used to create variable elements. Some of these tools will already be familiar to users from the Impose Editor and the PDF Editor. In addition, the VDP Editor's toolbar provides dedicated tools for creating variable elements – these tools are marked with the </>
symbol and are also applicable for editing paths.
Figure 4: The VDP Editor's toolbar in the browser with expanded sub-tools

The following tools are available in the VDP Editor:
-
Selection Tool [24] – used to select objects by clicking on them. The keyboard shortcut for the Selection Tool is
(V)
. -
Direct Selection Tool [25] – allows individual segments of an object or path to be selected and modified. First, select the object using the Selection Tool
(V)
, then use the Direct Selection Tool for further editing. The keyboard shortcut for the Direct Selection Tool is(A)
. -
VDP Text Tools [26] – these tools allow the user to create a path or object that serves as placeholders – with the default text «Sample Content» – for a VDP text element. Determine the position, content and appearance in the designated settings areas. When you press the button for this tool, the selection menu will open, allowing you to choose additional VDP text tools based on your application. These include:
- VDP Text Tool – creates a straight line as the baseline for positioning variable text. The keyboard shortcut for the Text Tool is
(T)
. - VDP Text Ellipse Tool – creates an ellipse or circle on which the variable text is positioned, either inside or outside the path.
- VDP Text Path Tool – creates a path consisting of straight line segments for the text placement. The corner points between the straight lines can later be converted into a curve point.
- VDP Bezier Curve Text Tool – creates a path consisting of curves, on which the variable text is positioned. The curve points between the curve segments can later be converted into a corner point.
- VDP Text Polygon Tool – creates a polygon shape for the text placement. The number of corners and the star shape can be defined while drawing or edited afterwards.
- VDP Text Tool – creates a straight line as the baseline for positioning variable text. The keyboard shortcut for the Text Tool is
-
VDP Barcode Tool [27] – click and drag to create a placeholder for a barcode or QR code. The keyboard shortcut for the VDP Barcode Tool is
(B)
. -
VDP Image Tool [28] – click and drag to draw a rectangle placeholder for a variable image element. The keyboard shortcut for the VDP Image Tool is
(I)
. -
VDP Object Creation Tools [29] – use these tools to create additional graphic elements with dynamically variable fill and stroke colors. Holding this tool opens a dropdown menu with further options:
- VDP Rectangle Tool – click and drag to create a rectangle. The keyboard shortcut for the VDP Rectangle Tool is
(R)
. - VDP Ellipse Tool – creates an ellipse or circle.
- VDP Multipath Tool – creates a path composed of straight lines. The respective corner points between the lines can later be converted into curve points.
- VDP Bezier Curve Tool – creates a path composed of curves. The respective curve points between the curve segments can later be converted into a corner point.
- VDP Polygon Tool – creates a polygon. The number of corners and the star shape can be configured during or after the creation.
- VDP Rectangle Tool – click and drag to create a rectangle. The keyboard shortcut for the VDP Rectangle Tool is
-
Edit Path Tool [30] – this tool allows for post-editing of paths by adding or deleting anchor path points and modifying tangent points. The keyboard shortcut for the Edit Path Tool is
(P)
. -
Scissor Tool [31] – this tool is used to cut open paths, for example to turn a circle into two semi-circles. The keyboard shortcut for the Scissor Tool is
(C)
. -
Measure Tool [32] – this tool allows you to set the start point of the measurement by clicking on the Print Item and to set the endpoint by clicking again. The distance and angle are displayed as you move the cursor. The keyboard shortcut for the Measure Tool is
(M)
. -
Hand Tool [33] – click and drag to move the Print Item within the editor workspace. This is especially useful in combination with the zoom functions. The keyboard shortcut for the Hand Tool is
(G)
. -
Zoom Tool [34] – activates a magnifying glass cursor with a «+» symbol. Holding down the
alt
oroption
key, the magnifying glass is displayed with a «-» symbol. The keyboard shortcut for the Zoom Tool is(Z)
. -
Fit to Width [35] – this tool automatically zooms to fit the Print Item to the page width. The keyboard shortcut for Fit to Width is
(W)
. -
Fit to Height [36] – this tool automatically zooms to fit the Print Item to the page height. The keyboard shortcut for Fit to Height is
(H)
. -
Reset Polygon Tool Settings to Default [37] – this tool can be used to reset the most recently used settings for the number of polygon sides and the star shape back to the default value – a regular pentagon. The keyboard shortcut for Reset Polygon Tool Settings to Default is
(D)
.
Handy Tips for Using the Tools
Guidance on how to work with the individual tools can be found in the article Handy Tips for Creating and Editing Variable Objects.
2.3. Tab «Transform & General Settings»
In the tab Transform & General Settings, functions with slightly varying options are available depending on the selected object. The tab is divided into two sections: Transform and General Settings.
Figure 5: The tab Transform & General Settings after selecting a VDP rectangle element

Transform
In the section Transform, the position and shape of the selected object are defined. The individual options may be active or inactive, depending on the selected tool.
Figure 6: The Settings options in the Transform area for a selected VDP Rectangle element

The following settings are available for selected objects:
- Origin and X or Y [38] – the origin of the selected object defines the starting point of the transformation, i.e., the point from which the transformation is applied. The X and Y coordinates specify the position of this origin point.
- Length [39] – the length of the object can only be edited when a VDP Image, VDP Barcode tool, or a VDP Object Creation tool is selected.
- Rotate [40] – Objects can be rotated as desired. Rotate is only available when using the VDP Image, VDP Barcode tool, or a VDP Object Creation tools.
- Mirror [41] – Objects can be mirrored horizontally or vertically. This option is available only when using the VDP Image, VDP Barcode, or VDP Object tools.
- Arrange [42] – moves the selected object to the forward or backward within the current layer.
- Convert Path Point [43] – using the Direct Selection Tool, an anchor point on the path can be selected and converted to either a curve point or a corner point by clicking the corresponding icon.
- Smoothing Type [44] – the smoothing type allows modification of the shape of a curve point. The following smoothing types are available: None, Symmetric, Catmull-rom, Continuous, and Geometric.
- Close Path [45] – this option automatically closes an open path by connecting its start and end points.
-
Origin [46] – defines the reference point used by the subsequent options Align and Distribute. The following options are available in the dropdown menu:
- Align to Selection
- Align to Sheet
- Custom
- ImageBox
-
Align [47] – aligns selected VDP elements based on the chosen reference origin. You can align the selected elements as follows:
- Align Left
- Align Horizontally Centered
- Align Right
- Align Top
- Align Vertically Centered
- Align Bottom
-
Distribute [48] – distributes the selected VDP elements based on the chosen reference origin. You can distribute the selected elements as follows:
- Distribute Horizontally
- Distribute Vertically
General Settings
In the section General Settings, Global Settings for variable data are defined. The configured settings can be applied across all tools and objects.
Figure 7: The Settings options in the General Settings area

The following options are available in the settings area:
- File Name [49] – displays the file name of the currently loaded control file (CSV).
- Upload/Replace CSV File [50] – allows uploading a new CSV file or replacing an existing one.
- Download [51] – enables downloading the currently uploaded CSV file (deletion is not possible).
- Delete CSV File [54] – the currently uploaded CSV file can be downloaded (but not deleted).
- Show CSV File [55] – displays the CSV file in a list view, enabling you to check the content.
- Records per Print Item [52] – defines how many records or rows from the control file are used per Print Item. This option is required when multiple Print Items are imposed next to each other and combined into one layout. The variable elements will be applied sequentially across that layout.
- Select Image Directory [53] – specifies the directory containing images referenced in the control file. Ensure that the server path to these images has already been set up under Administration > File Management in the Workflow.
2.4. Tab «Content»
The tab Content defines which content is used for the variable element. This tab is only accessible if a variable element has been created using one of the available tools and the created element is currently selected.
The structure of the tab always follows the same logic. The following three sections are available.
-
Data Source [56] – select the origin (source) or rule from which the content should be generated. The following data sources are available:
- String – the content can be freely defined in the text field. Placeholders can be used, such as entries from a CSV file, serial numbers, or a date.
- Date – the content is defined by a date. Additional settings allow the generation of dynamic dates based on parameters, as well as the selection of different date formats.
- Serial Number – the content of the variable element is generated based on a serial number definition, which can be freely configured.
- Column Index – the content is retrieved from the CSV control file. By selecting a Column Index, specifies which column of the CSV file should be used for each data record. You can also define the starting row or whether the content should be trimmed.
- Column Title – similar to the column index, the content is sourced from the CSV control file. By selecting a Column Title, you can define which column in the CSV file should be used for each individual record. In addition, you can specify the starting row and whether content should be trimmed.
- Definition Area [57] – depending on the selected data source, this area offers options for configuring or assembling the desired content.
- Preview [58] – displays a preview of the content generated by the selected options for the current and subsequent records.
Figure 8: The three areas of the tab Content with selected Data Source String

Data Source «String»
If String is selected under the option Data Source [56] (Figure 8), any desired text can be entered in the Definition Area [59], or dynamic content can be generated using placeholders [60].
Once a string has been defined, the user must click Update [62] to display the final string on the Print Item.
Figure 9: The tab Content with the Data Source String selected

The user can enter any text into the input field. If you want to insert a placeholder into the text, one of the following two methods can be used:
- Insert placeholder [60] – clicking this button opens the dialog Choose Placeholder.
- @ Symbol – insert the @ symbol also opens the dialog Choose Placeholder.
In the dialog Choose Placeholder, select the placeholder you want to use. When you Save the dialog, the corresponding Placeholder Code is inserted into the text field of the Definition Area [59]. To configure the Placeholder, you can either modify the values directly within the code or place the cursor inside the sub-variable in the text and enter the corresponding values in the section Parameter Configuration [61].
Figure 10: The dialog Choose Placeholder

Data Source «Serial Number»
If the option Serial Number [63] is selected as the Data Source, both the serial number sequence and the width of the serial number can be configured.
Figure 11: The tab Content with the Data Source Serial Number

The following options are available for defining a Serial Number:
- Start [64] – specifies the number at which the serial numbering should begin.
- Increment [65] – defines the increment between serial numbers. The step value is applied to all subsequent numbers.
- Width [66] – specifies the minimum number of digits for the serial number. If the number is shorter than the defined width, leading zeros will be added.
- Randomly Distributed [67] – specifies whether the Serial Numbers should be generated in ascending, descending, or randomly order. In all cases, each Serial Number is used only once.
- Start again after [68] – specifies after how many records the Serial Numbering should restart. Example: A Value of 5 results in the sequence: 1, 2, 3, 4, 5, 1, 2, 3, ...
- Repeats [69] – defines how many times each Serial Number should be repeated. Example: A Value of 3 results in the sequence: 1, 1, 1, 2, 2, 2, 3, 3, 3, ...
Data Source «Date»
If Date [70] is selected as the option Data Source, you can either define a fixed date or generate a date based on the system date with an optional offset. Additionally, you can specify the format in which the date should be displayed.
Figure 12: The tab Content with selected Data Source Date

The following configuration options are available for defining a Date:
- Options [71] – select whether the date should be a sequential series, a fixed/static date, or a date depending on the System Date + Offset.
- Offset [72] – define the number of days to add to the System Date. This setting is only applicable when System Date + Offset is selected.
- Format [73] – select the desired output format for the date, e.g., 10.04.2022, 10.04.22, 10 April 2022, Sun, 10 April 2022 ...
- Language [74] – choose the language which should be used for day and month names, e.g., June 12, 2022, Sun June 12, 2022 | June 12, 2022, Sun June 12, 2022 ...
Data Source «Column Index»
If the option Column Index [75] is selected as the Data Source, you can specify the desired column from the uploaded CSV file and optionally trim the text content. If multiple records from the CSV file need to be placed on a single Print Item, an offset within the defined range can also be configured.
Note: The option Column Index is only available if a CSV file has been uploaded beforehand in the tab Transform & General Settings.
Figure 13: The tab Content with selected Data Source Column Index

After selecting a Column Index, the following configuration options are available:
- Column Index [76] – select the desired column from the CSV file. The dropdown will only display as many index numbers as there are columns in the underlying CSV file.
- From the beginning [77] – specify how many characters from the beginning of the content should not be displayed. The value from the CSV file will be trimmed by the entered number of characters starting from the beginning. If a negative value is entered, the content will be trimmed starting from the end.
- From Position [80] – enter the number of characters from the beginning of the string that should be used. Example: The value 7 trims 00_Textkette_01 to 00_Text.
- Relative Line Index [78] – define the record offset that should be used for the variable element. This option is only relevant if a value greater than 1 has been selected in the option Records per Print Item in the tab Transform & General Settings. For example, if 3 Records per Print Item are selected, you have to enter the value 0 for the first variable element, the value 1 for the second variable element, and the value 2 for the third variable element in Relative Line Index.
-
Display Options [79] – choose from the following two display modes:
- Show shortest entry – forces the display of the shortest entry from the CSV file.
- Show longest entry – forces the display of the longest entry from the CSV file. Please note that the length is limited to the number of characters and not to the space required (text length)! Therefore, a shorter entry containing many wide characters such as w, m, o, etc. may still exceed the available space and will not fit the given path length.
Data Source «Column Title»
If the entry Column Title [81] is selected as the Data Source, you can both select the desired column from the CSV file and trim the content of the text as needed. If multiple data records from a CSV file should be placed on a Print Item, the appropriate offset within the defined area can be specified.
Please note that Column Titles can only be selected if a CSV file has been uploaded beforehand in the tab Transform & General Settings.
Figure 14: The tab Content with the selected Data Source Column Title

The available options are identical to those provided for the data source Column Index. For further details, refer to the description below Figure 13.
2.5. Tab «Format»
The options in the tab Format define the visual appearance of the variable elements. The tab is only accessible when a variable element has been created using one of the available tools and the created element is selected.
Figure 15: The available Settings Area for Text Format, Barcode Format, Image Format and Object Format
Depending on the selected variable element, different formatting options are made available in the tab Format, grouped into expandable settings areas. The following setting areas are present:
- Blend Mode [82] – the Blend Mode (blend mode) defines how the content of the object interacts with the background. For example, the blend mode Normal sets the background to Knockout, while the blend mode Multiply sets the object to Overprint. Additional options include Screen, Overlay, Darken, Lighten, Difference, Exclusion, Hue, Saturation, Color, Luminosity, Color-dodge, Color-burn, Hard Light, and Soft Light.
- Text Settings [83] – allows you to configure the text Alignment, Position, and Offset from the starting point along the path. Available Alignment options include Align Left, Align Centered, and Align Right.
- Font Settings [84] – set the Font Family, Font Style, Font Size, Horizontal and Vertical Scaling, Character Spacing, and Text Fitting options. You can also add an outline with configurable Stroke Width and dashed line settings by specifying the Dash and Gap length.
- Fill Color Settings [85] – enables the selection of static color values for fill (including barcodes) using CMYK or Spot Colors, or values from the Data Source (CSV file) for dynamically setting Stroke Colors.
- Stroke Color Settings [86] – similar to Fill Color Settings, this section allows you to choose either static color values for strokes based on CMYK values or Spot Colors, or values from the Data Source (CSV file) for dynamically setting Stroke Colors.
- Barcode Settings [87] – provides barcode and QR code settings as already known from the Impose Editor. The available parameters vary depending on the barcode type.
- Background [88] – allows for setting a static background color for barcodes using CMYK color values or system-wide Spot Colors, or using values from the Data Source (CSV file) to dynamically generate barcode background colors.
- Image Settings [89] – select the Horizontal or Vertical Alignment – Align Left, Align horizontally centered, Align Right or Align Top, Align vertically centered, Align Bottom – as well as Image adjustment options – Fit Image - keep proportions and Fill Image - keep proportions. If the image should be streched to fill the available space completely, the Stretch checkbox can be activated.
- Rectangle Settings [90] – define the Stroke Width, Corner Radius, and Dash / Gap length for defining dashed lines. The Ellipse and Path settings offer a subset of these functions.
2.6. Tab «Layer»
The tab Layers allows you to create variable elements on either the highest or lowest layer, toggle the visibility of variable elements, and delete them as needed.
You can define the layer on which a variable element is created by selecting either the layers VDP on highest layer or VDP on lowest layer. Variable Data Printing (VDP) elements placed on the selected layer are arranged below. Moving objects from one layer to another is possible by simply drag and drop it to the desired layer position.
Figure 16: The tab Layers with variable elements on the highest and lowest layer

After variable elements have been placed on the highest resp. lowest layer, the following functions are available:
- Expand / Collapse Layer [93] – click the arrow icon to expand or collapse the list of elements assigned to the respective layer.
- Show / Hide Layer / VDP element [91] – click the icon to hide or show either all objects on a layer or individual VDP elements.
- Lock / Unlock Layer [95] – locking a layer prevents its objects from being accidentally moved during editing. The layer can be unlocked at any time to enable changes.
- Set Layer Color [92] – click the color bar to assign a custom color to the layer. Selected objects will then appear within a selection box in the chosen layer color.
-
Delete VDP Element [87] – to remove a VDP element from the Print Item, click the trash icon. The element will be deleted immediately without confirmation. Accidental deletions can be undone using
cmd
+Z
(macOS) orctrl
+Z
(Windows).
VDP Elements on the Lowest Layer are not visible
Please note that VDP elements placed on the lowest layer are only visible if the Print Item is a transparent layout – i.e., one without a background layer. Check the Print Item beforehand by activating the TR mode from the menu bar of the VDP Editor.
Locked Layers are unlocked after saving
Please note that all layers will be unlocked upon reopening the VDP Editor, even if they were locked when the file was last saved. Layer locking therefore only applies during the creation and editing of the VDP Job.
Hidden VDP elements become visible after saving
Please note that any hidden VDP elements will be reactivated upon saving the Print Item and will be included in the output. If a VDP element should not be appear in the final output, the VDP element must be deleted before saving!
Artikel update: Workflow version 1.19.0 – 05/2025