In this article, you will learn
- where to find the VDP Editor within the Workflow,
- how to open and close the VDP Editor,
- how the user interface of the VDP Editor is structured, and
- how a created VDP order is displayed in the user interface of the Workflow.
1. Introduction
Placing variable elements on a Print Item is done within the Workflow using the tab Variable Data in the Print Item View of an Article or a Print Item within an Order or Production Job.
Tab Variable Data
Up to version 1.13.0, variable data could also be applied 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 available to users in version 1.12.0 via the tab Variable Data in the Print Item View of an Article or a Print Item within an Order or Production Job.
The following description refers to the user interface of the VDP Editor, which allows variable data and elements to be placed directly in the browser and enriched with data from a CSV file – all without the need to open the Print Item in Adobe Illustrator.
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 button VDP Editor [2]. Optionally, you can upload the desired control file in advance by clicking the button Add CSV File [3] in the tab. If you skip this step, you can still add, delete, or replace a CSV file at any time within the VDP Editor.
- The VDP Editor will then open. Please note that this may take a moment for larger images, as all required resources must be loaded 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 functions for saving, closing, showing 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 displayed in the system-defined unit of measurement.
- Toolbar [6] – provides tools required to create and edit variable elements.
- Artboard [7] – the workspace for placing objects or displaying the Print Item, including the ImageBox [8] – final visible format – and the Bleed Area [9], where no variable elements should be placed.
- Settings Area [11] – provides functions and displays relevant information, divided into four tabs [10].
2. Elements of the User Interface
The user interface of the VDP Editor is based on a familiar structure already known to the user from the Impose Editor or the general user interface of the Workflow. In addition to the menu bar and toolbar, it features an Artboard as well as predefined settings areas for parameterizing variable elements. The following section provides an overview of these elements. Instructions on how to place and configure specific variable elements such as Serial Numbers, Variable Barcodes or QR-Codes, Variable Fill or Stroke Color, and Variable Images can be found in the respective articles. Important considerations when creating or editing variable elements are covered 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 contains the following information and functions from left to right:
- Print Item or Article Name [12] – displays the name of the underlying Print Item enriched with variable elements. Please note that the Print Item or Article Name may differ from the actual file name.
- Save [13] – saves the current VDP specification, including the position, shape, and content of all variable elements.
- Close [14] – closes the VDP Editor without saving the current VDP specification.
-
Edit [15] – provides functions for copying and pasting VDP elements. The following options are available in the dropdown menu:
-
Cut (
Ctrl
+X
orcmd
+X
) – cuts the selected VDP element and places it on the clipboard. -
Copy (
Ctrl
+C
orcmd
+C
) – copies the selected VDP element to the clipboard. -
Paste (
Ctrl
+V
orcmd
+V
) – pastes the clipboard contents to the center of the Print Item. -
Paste at Original Position (
Ctrl
+Shift
+V
orcmd
+Shift
+V
) – pastes the clipboard contents at its original position on the Print Item.
-
Cut (
- Warning Triangle [16] – displays warnings and errors that occur within the VDP Editor. These messages help validate VDP Jobs by alerting users early to issues that could affect output quality.
- Help [17] – displays available keyboard shortcuts to support fast and efficient use of the VDP Editor.
- VDP Editor Settings [18] – provides configuration options to customize the behavior of the VDP Editor to ensure a smoother operation.
- Dim Static Content [19] – when enabled, all static elements are dimmed according to percentage set in the VDP Editor Settings. This helps users more easily identify variable elements. When the function is active, the icon appears green.
- ImageBox [20] – when the icon is yellow, the ImageBox dimensions are displayed in the VDP Editor, allowing users to quickly check whether variable elements are placed too close to or beyond the TrimBox ([8] in Figure 2). If the icon is gray, the ImageBox is hidden.
- ImageBox + Bleed [21] – when the icon is turquoise, the Bleed area ([9] in Figure 2) is displayed in the VDP Editor. This helps users assess whether sufficient Bleed is present or whether Bleed needs to be added using a Fixup. If the icon is gray, the Bleed area is hidden.
- Show Transparency Grid [22] – toogles the visibility of transparent areas in the Print Item by displaying a checkerboard pattern, helping 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 predefined zoom levels for quick selection.
2.2. Toolbar
The VDP Editor also includes several tools that can be used for creating variable elements. Some of these tools will already be familiar to users from the Impose Editor and the PDF Editor. In addition, the toolbar of the VDP Editor includes specialized tools for creating variable elements – these tools are marked with the symbol </>
– as well as tools for editing paths.
Figure 4: The toolbar of the VDP Editor in the browser, with expanded sub-tools

The following tools are available in the VDP Editor:
-
Selection Tool [24] – allows you to select objects by clicking on them. The shortcut key for the Selection Tool is
(V)
. -
Direct Selection Tool [25] – enables the selection of segments of an object or path for further modification. First, select the object to be modified using the Selection Tool
(V)
, then use the Direct Selection Tool for editing. The shortcut key for the Direct Selection Tool is(A)
. -
VDP Text Tools [26] – these tools allow you to create a path or object that serves as a placeholder – with the default text "Sample Content" – for a VDP text element. The position, content, and appearance can be configured in the appropriate settings areas. Holding the tool icon opens a submenu with additional VDP Text Tools suited to different use cases. These include:
-
VDP Text Tool – creates a straight line on which the variable text is positioned. The shortcut key for the Text Tool is
(T)
. - VDP Text Ellipse Tool – creates an ellipse or circle along which the variable text is positioned, either inside or outside the path.
- VDP Text Path Tool – creates a path composed of straight lines, on which the variable text is positioned. Corner points between the straight lines can later be converted into curve points.
- VDP Bezier Curve Text Tool – creates a path composed of curves, on which the variable text is positioned. Curve points between the curve segments can later be converted into corner points.
- VDP Text Polygon Tool – creates a polygon on which variable text is positioned. The number of corners and star shape can be defined during creation and adjusted afterwards.
-
VDP Text Tool – creates a straight line on which the variable text is positioned. The shortcut key for the Text Tool is
-
VDP Barcode Tool [27] – click and drag to create a placeholder for a barcode or QR code. The shortcut key for the VDP Barcode Tool is
(B)
. -
VDP Image Tool [28] – you can click and drag to draw a rectangle that serves as a placeholder for the variable image element. The shortcut key for the VDP Image Tool is
(I)
. -
VDP Object Creation Tools [29] – used to create additional graphic VDP objects whose fill and stroke colors can be set variable. Holding the tool button opens a dropdown menu with additional shape options:
-
VDP Rectangle Tool – click and drag to draw a rectangle. The shortcut key 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. Corner points between the lines can later be converted into curve points.
- VDP Bezier Curve Tool – creates a path composed of curves. Curve points between the curve segments can later be converted into corner points.
- VDP Polygon Tool – creates a polygon. The number of corners and star shape can be defined during creation and adjusted afterwards.
-
VDP Rectangle Tool – click and drag to draw a rectangle. The shortcut key for the VDP Rectangle Tool is
-
Edit Path Tool [30] – this tool allows paths to be modified retrospectively by adding or deleting anchor path points, as well as adjusting tangent points. The shortcut key for the Edit Path Tool is
(P)
. -
Scissor Tool [31] – this tool allows paths to be cut retrospectively, for example to split a circle into two semicircles. The shortcut key for the Scissor Tool is
(C)
. -
Measure Tool [32] – you can click on the Print Item to set the starting point of the measurement, and click again to set the endpoint. As you move the mouse cursor, the current measurement distance and angle are displayed. The shortcut key for the Measure Tool is
(M)
. -
Hand Tool [33] – this tool allows you to move the Print Item within the editor workspace by clicking and dragging the mouse. It is especially useful when used in combination with the zoom function. The shortcut key for the Hand Tool is
(G)
. -
Zoom Tool [34] – when this tool is selected, the mouse cursor changes to a magnifying glass with a "+" symbol inside. If you additionally hold down the key
alt
oroption,
the magnifying glass will display a "-" symbol instead. The shortcut key for the Zoom Tool is(Z)
. -
Fit to Width [35] – this tool automatically zooms to fit the width of the Print Item. Note that selecting this tool immediately triggers the zoom-to-width action. The shortcut key for Fit to Width is
(W)
. -
Fit to Height [36] – this tool automatically zooms to fit the height of the Print Item. Note that selecting this tool immediately triggers the zoom-to-height action. The shortcut key 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 pentagon. The shortcut key for Reset Polygon Tool Settings to Default is
(D)
.
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"
The tab Transform & General Settings offers functions with slightly different options 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
The settings section Transform defines the position and shape of the selected object are defined. Individual options are enabled or disabled depending on the selected tool.
Figure 6: Settings options available in the section Transform for a selected VDP Rectangle element

The following settings are available for selected objects:
- Origin and X or Y [38] – the origin defines the starting point for transformations, i.e., the reference point from which the transformation is applied. The X and Y coordinates specify the position of the selected origin point.
- Width and Height [39] – the width and height of the object can only be modified when a VDP Image Tool, VDP Barcode Tool, or a VDP Object Creation Tool is selected.
- Rotate [40] – objects can be rotated as desired. Rotate is only available when a VDP Image Tool, VDP Barcode Tool, or a VDP Object Creation Tool is selected.
- Mirror [41] – objects can be mirrored either horizontally or vertically. This option is only available when using a VDP Image Tool, VDP Barcode Tool, or a VDP Object Creation Tool.
- Arrange [42] – moves the selected object to the forward or backward within the currently active layer.
- Convert Path Point [43] – using the Direct Selection Tool, an anchor point on a path can be selected and converted into a curve point or a corner point by clicking the corresponding icon.
- Smoothing Type [44] – by selecting a smoothing option, the shape of a curve point can be modified. Five different options are available: None, Symmetric, Catmull-rom, Continuous, and Geometric.
- Close Path [45] – this option automatically closes an open path by connecting its end point to the starting point.
-
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] – specifies to which edge the selected VDP elements should be aligned based on the chosen 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] – defines how the selected VDP elements should be distributed based on the chosen origin. You can distribute the selected elements as follows:
- Distribute Horizontally
- Distribute Vertically
General Settings
The section General Settings defines Global Settings for the variable data. The configured settings can be applied to all tools and objects.
Figure 7: The Settings options in the section General Settings

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] – uploads a new CSV file or replaces an existing CSV file.
- Download [51] – allows downloading of the currently uploaded CSV file (deletion is not possible).
- Delete CSV File [54] – the currently uploaded CSV file can be downloaded (but not deleted).
- View CSV File [55] – displays the CSV file in a list view to enable content verification.
- Records per Print Item [52] – defines how many records or rows from the control file are used per Print Item. This option is necessary when multiple Print Items are imposed next to each other and combined into one layout. Variable elements should be applied sequentially on this layout.
- Select Image Directory [53] – specifies the directory containing images referenced by 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 determines which content will be used for the variable element. This tab is only accessible if a variable element has been created with one of the available tools and the created element is selected.
The structure of the tab always follows the same logic. The following three sections are available:
-
Data Source [56] – select here the origin (source) or rule based on which the content should be generated. The following data sources are available:
- String – the content can be freely defined in the text field. Placeholders, such as entries from a CSV file, serial numbers, or a date, can be used.
- Date – the content is defined by a date. Additional options allow generating a date dynamically based on parameters or choosing different date formats.
- Serial Number – the content of the variable element is generated based on a serial number definition. The serial number can be freely configured.
- Column Index – the content is retrieved from the CSV control file. By selecting a Column Index, you specify which column in the CSV file is used for the individual record. It is also possible to define the starting row or whether contents should be trimmed.
- Column Title – the content is retrieved from the CSV control file. By selecting a Column Title, you specify which column in the CSV file is used for the individual record. It is also possible to define the starting row or whether contents should be trimmed.
- Definition Area [57] – depending on the selected data source, this section offers options allowing the user to assemble or select the desired content.
- Preview [58] – this section displays a preview of the content that the user would generate through the chosen options for the current or subsequent records.
Figure 8: The three sections of the tab Content with selected Data Source String

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

You can enter any text in the input field. If you want to enrich the text with a placeholder, one of the following two methods can be used:
- Insert Placeholder [60] – clicking the button opens the dialog Choose Placeholder.
- @ Symbol – inserting the @ symbol in the input field also opens the dialog Choose Placeholder.
In the dialog Choose Placeholder, select the placeholder you want to use. Once you Save the dialog, the corresponding Placeholder Code is inserted into the text field of the Definition Area [59]. To parameterize the Placeholder, you can either edit the values directly in the code or place the cursor inside the sub-variable within 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, you can configure the serial number sequence as well as the width of the serial number .
Figure 11: The tab Content with the Data Source Serial Number

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

The following options are available for defining a Date:
- Options [71] – select whether to create a series, a static date, or a date depending on the System Date + Offset.
- Offset [72] – specify the number of days to be added to the System Date. This option is only available if 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] – select the language which should be used for weekday 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 choose the desired column from the CSV file and optionally trim the text content. If multiple records from a CSV file need to be placed on a single Print Item, the corresponding offset within the defined range can be specified.
Note that the option Column Index is only available if a CSV file has previously been uploaded in the tab Transform & General Settings.
Figure 13: The tab Content with selected Data Source Column Index

After selecting a Column Index, the following options are available:
- Column Index [76] – select the desired column from the CSV file. The dropdown will only display as many index numbers as are found 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 from the beginning. If a negative value is entered, the content will be trimmed from the beginning based on the number of characters counted backwards from the end. Example: A value of "3" trims "00_TextString_01" to "TextString_01". A value of "–2" trims "00_TextString_01" to "01".
- From Position [80] – specifies how many characters of the string, starting from the beginning, should be used. Example: A value of "7 "trims "00_Textstring_01" to "00_Text".
- Relative Line Index [78] – select the offset to be used within the dataset for the variable elements. This option is only relevant if, in the tab Transform & General Settings, a value greater than 0 has been specified under the option Records per Print. Item. For example, if "3" Records per Print Item were selected, you must enter the value 0 for the first variable element, the value 1 for the second variable element, the value 2 for the third variable element in this option.
-
Display Options [79] – you can choose between two options:
- Show shortest entry – forces the display of the shortest entry found in the CSV file.
- Show longest entry – forces the display of the longest entry found in the the CSV file. However, note that the length refers to the number of characters, not the actual space required (text width)! As a result, shorter datasets containing many wide characters such as w, m, o, etc. may still exceed the available path length.
Data Source "Column Title"
If the option Column Title [81] is selected under Data Source, you can choose the desired column from the CSV file and trim the content of the text as needed. If multiple records from a CSV file are to be placed on a Print Item, the appropriate offset within the defined area can be specified.
Note that Column Titles can only be selected if a CSV file has previously been uploaded 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 when the data source Column Index is selected. For more detailed information, refer to the description below Figure 13.
2.5. Tab "Format"
The options available in the tab Format define the appearance of variable elements. This 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, organized into expandable configuration sections. The following setting areas are present:
- Blend Mode [82] – the Blend Mode (Blend Modes) defines how the content of the object is composited 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 blend modes include: Screen, Overlay, Darken, Lighten, Difference, Exclusion, Hue, Saturation, Color, Luminosity, Color-dodge, Color-burn, Hard Light, and Soft Light.
- Text Settings [83] – this section allows you to define the Alignment, Position, and Offset of the text relative to the starting point on the path. Available Alignment options include Align Left, Align Centered, and Align Right.
- Font Settings [84] – here, you can configure the Font Family, Font Style, Font Size, Horizontal and Vertical Scaling, Character Spacing, and Text Fitting options. Additionally, Stroke Settings such as Stroke Width and the ability to define dashed lines by specifying the Dash and Gap lengths are available.
- Fill Color Settings [85] – you can either assign static fill colors (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] – here, you can select the Horizontal or Vertical Alignment – Left, Horizontally centered, Right or Top, Vertically centered, Bottom. You can also choose the image fitting mode: Fit Image – keep proportions and Fill Image – keep proportions. If the image should be stretched to fully cover the available frame, the Stretch checkbox can be activated.
- Rectangle Settings [90] – define the Stroke Width, Corner Radius, as well as the Dash / Gap lengths for creating a dashed line. The Ellipses and Path settings, the corresponding subset of settings can be used accordingly.
2.6. Tab "Layer"
The tab Layers provides options to place variable elements either on the highest or lowest layer. It also allows users to toggle or delete individual variable elements.
The Layer on which a variable element is created can be determined by selecting either the layers VDP on highest layer or VDP on lowest layer. Variable Data Printing (VDP) elements placed on a layer are arranged accordingly below that point. Moving objects between layers can be done simply by dragging and dropping the variable element from one layer to another.
Figure 16: The tab Layers with variable elements on the highest and lowest layer

After placing variable elements on the highest resp. lowest layer, the following functions are available:
- Expand / Collapse Layer [93] – clicking the arrow icon displays or hides the list of elements assigned to the layer.
- Show / Hide Layer / VDP element [91] – all objects on the layer or individual VDP elements can be shown or hidden by clicking the corresponding icon.
- Lock / Unlock Layer [95] – locking a layer prevents its objects from unintentional repositioning of objects during editing. The layer can be unlocked at any time to enable changes.
- Set Layer Color [92] – clicking the colored stripe opens a color selection for the layer. Selected objects will be highlighted with a selection rectangle in the chosen layer color.
-
Delete VDP Element [87] – to remove VDP elements from the Print Item, click the trash can icon. The element will be deleted immediately without further information. 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 area. Check the Print Item in advance by activating the TR mode from the menu bar of the VDP Editor.
Locked Layers are unlocked after saving
Please note that after reopening the VDP Editor, all layers will be unlocked, even if they were locked prior to saving. Layer locking therefore only applies during the creation and editing of the VDP Job.
Hidden VDP elements become visible after saving
Please note that hidden VDP elements will be reactivated after saving the Print Item and will therefore be included in the output. If a VDP element should not be appear in the output, the VDP element must be deleted before saving!
Article update: Workflow version 1.19.0 – 05/2025