KuikCodeDocs
KuikCodes

Create many codes from a CSV

One spreadsheet row per code, one design for the whole batch, all filed in one folder.

Turn on Create multiple KuikCodes from a CSV at the top of Step 1. The panel walks through three steps: download the template, fill one row per code, drop the file. Design the batch in Step 2 as you would a single code; every row gets that design. In Step 3 the Name becomes the folder the batch lands in.

The template

KuikCode Name,Destination URL,Tags,UTM parameters,GPS (yes/blank)
  • KuikCode Name and Destination URL are required. Bare domains are accepted and become https links.
  • Tags are separated by commas or semicolons, lowercased and de-duplicated, up to 20 per code.
  • UTM parameters take source=qr&medium=print&campaign=spring style pairs.
  • GPS set to yes turns on precise scan locations for that row.

Column headers are matched loosely (URL, Link, Labels all work) and extra columns are ignored.

Limits

A batch holds up to the plan's bulk rows ceiling: 100 on PRO, 500 on Business, and has to fit under the workspace's code ceiling. Batches are all or nothing: a bad row is reported with its line number and nothing is created until the file is fixed. A workspace can start ten batches every ten minutes.

After the upload

Create N KuikCodes creates the folder and the codes together. The success dialog offers a ZIP with every code's artwork, named after the rows. Each code is a normal KuikCode afterwards: edit, move, archive or repoint them one by one, or use Update many codes in the API.

GS1 batches

Switch on GS1 Digital Link together with bulk mode to create one GS1 code per product. The template gains GTIN and product columns; see GS1 batches.

From the API

POST /codes/bulk takes the same rows as JSON, see the reference.

On this page