Home › Docs › Addons › Bulk Personalization (CSV)
Bulk Personalization (CSV)
$9 One design, one list, one print file per row: name badges, labels, business cards, place cards and other variable-data jobs.
Every purchase is a single signed, install-ready ZIP that also includes full TypeScript/Vue source, sourcemaps, and build tooling (npm ci && npm run build) if you want to customize it yourself. On sale from Veyo 1.10.0.
What Bulk Personalization does
Variable-data orders usually arrive as a spreadsheet and a proof for every row. With this addon the customer designs once, puts fields such as {{name}} or {{title}} into the text, and adds the whole list in the designer. The canvas previews each row, the cart holds one line whose quantity is the number of rows, and the shop gets a print file per row.
How to enable it
-
Buy the addon
Your Polar purchase email (and the Polar customer portal) contains the addon ZIP and its license key.
-
Upload it in the Veyo Apps screen
Open Veyo Personalizer → Extensions and upload the ZIP. Activate its license key when asked.
-
Check the limits
Open Veyo Personalizer → Bulk CSV to set the rows per order line, the fields per design, the value length and the optional fees. The defaults fit most shops.
How customers use it
-
Add fields
In the designer’s Text panel, the Bulk list tab has Add field, which puts a text layer such as
{{name}}in the print area. Any text layer can hold fields, also mixed with fixed text (Hello {{name}}). Select the layer on the canvas to change its font, colour and position like any other text. -
Add the list
Upload CSV or Paste a table copied from a spreadsheet (CSV, TSV or an Excel paste). A header row is matched to the fields by name; without one, columns are taken in order, and the mapping can be changed before importing. Download sample CSV gives a file with the right header, and rows can be typed and edited in the table.
-
Preview every row
The ‹ › buttons step through the list and the canvas shows each row. A value that is too wide for its layer is shrunk to fit. The quantity follows the list: 120 rows are 120 items.
At a glance
| Version | 1.0.0 |
|---|---|
| Platforms | WordPress + WooCommerce, OpenCart 4, PrestaShop 8 & 9, Shopware 6.6 / 6.7. |
| Requires | Veyo Product Personalizer 1.10.0 or later. PHP zip extension for the print-file ZIP. |
| Where settings live | Veyo Personalizer → Bulk CSV. |
| Server tools / outside services | The per-row PNGs are made on the server: PHP exec(), librsvg and ImageMagick. If your host disables exec() the Bulk files ZIP cannot be built; the Download PNG button on the order’s production page renders the view in your browser instead, at 300 DPI, with the first row as saved in the design. Nothing is sent to outside services. |
Settings
| Setting | Default | Range |
|---|---|---|
| Rows per order line | 100 | 1–500 |
| Fields per design | 8 | 1–10 |
| Value length (characters) | 60 | 1–100 |
| Per personalized row | 0 | Store base currency, 0 = no charge |
| Setup fee per order line | 0 | Store base currency, 0 = no charge |
| Field used in file names | First field | A field name, for example name |
The designer reads the same limits, so the panel stops where the server would refuse. Large lists take time: each row is about half a second at 300 DPI on a 20 × 30 cm print area, so 100 rows take about a minute on the first download. The ZIP is kept, so later downloads are immediate.
What you get in orders and production
- Checked on the server. When the item is added to the cart the server checks the number of fields and rows, value length, unprintable characters and empty rows, that every field is used by a text layer, and that the quantity matches the list. A changed request is refused.
- Priced on the server, with the optional per-row and setup fees.
- One summary line. Cart, checkout, order page and emails show
Bulk: 120 rows; order pages and emails also list the first five rows. - A print file per row. On the order’s design page, each view with a field layer gets a Bulk files (N) button. It downloads a ZIP with a 300 DPI PNG and an SVG per row (
001-alex.png, …) plusdata.csvfor checking the run. See Orders & production. - Cart quantity. The designer’s quantity controls are locked while there is a list, and the cart quantity of a bulk line is locked on WooCommerce, OpenCart, PrestaShop and Shopware.
- A design cannot carry a team list (Team Names & Numbers) and a bulk list at the same time.
Not in this version: images, QR codes or barcodes per row, serial numbers, and multi-line values.
Installing, updating and removing
- Install: upload the ZIP in Extensions, then enable it. See Install addons.
- Update: upload the newer ZIP over the old one. Settings and data are kept. See Upgrading.
- Remove: Uninstall on the addon card removes its files and keeps its data. See Uninstalling & your data.