How to Set Variables for Batch Processing?
Updated Dec 5,2025
Updated Dec 5,2025

1. Unite or combine objects

If you need to set multiple objects as one variable, please unite or combine them into one. (A variable can only be set for one object.)

image.png


Example of compounding:

image.png Separated:

2A0E5E76-C031-42B4-8F84-1AFCC7024BF2.GIF

image.png Compounded:

AF0692FA-500D-4A49-BE92-590303E896BE.GIF

Example of uniting:

image.png Compounded:

FB39834B-E7C3-475D-B910-63758BA56B6F.GIF

image.png United:

2DF225D8-70CB-4A1E-AAD4-CA3339D29023.GIF


2. Set variable

(1) On the right of xTool Studio, select Different design - batch processing as the processing mode. Then, click Set variable.

image.png


(2) Select the object you want to set as a variable, and click + Add variable.

image.png


(3) For an added variable, set fill and alignment relative to the original object.

image.png


(4) After setting all the variables, click Next.

image.png



3. Associate data

Manually input data

(1) Click + Add, and then a new row will be added, which indicates another design to be printed.

image.png


The first row indicates the original design.



(2) Change objects for each variable.

  • For a vector, click Replace vector and choose a vector from the local to upload.
    image.png

Supported vector formats: SVG, DXF


  • For a bitmap image, click Replace image and choose an image from the local to upload.
    image.png

Supported image formats: PNG, JPG, JPEG, BMP, WEBP


  • For text, double-click the text to edit it.
    image.png


Import data in batches

(1) Click Download template to download a ZIP file. Unzip the file, and you can see an XLSX file and all of your original vector or bitmap objects in the folder.

image.png

image.png

(2) Add the new objects you want to print into the folder xTool batch design – data upload template.

Supported vector formats: SVG, DXF

Supported image formats: PNG, JPG, JPEG, BMP, WEBP

image.png


(3) Open the file xTool batch design – data upload template.

In the table, the third row indicates the original design you created in xTool Studio. Under this row, input the name of the vector or image files you added to the xTool batch design – data upload template folder. And edit the text for the text variables.

image.png

For each row you added, do not leave any variable blank. Otherwise, the whole row will not be printed.


(4) Save the file and zip the folder. In xTool Studio, click Import to import the new folder.

image.png



Preview
Was this page helpful?
0 out of 0 found this helpful
Help Ticket
Use this help ticket to submit your issue. We will respond within 1 business day
Submit a Ticket
Help Ticket
Use this help ticket to submit your issue. We will respond within 1 business day
Submit a Ticket
xTool Logo

Contact Us

🇺🇸+1 (833) 588-4887
Service Live Chat

Copyright © 2025 xTool All Rights Reserved.