You can add custom metadata to any QR Code to store additional information specific to your use case. This helps you tag, categorize, or track QR Codes for internal reporting, integrations, automation, and more. Metadata is stored as JSON key–value pairs and can be managed through the API, bulk operations, or directly from the dashboard.
What is metadata?
Metadata is extra information you attach to a QR Code in the form of JSON key–value pairs.
For example:
{"campaign":"summer_25","region":"APAC","priority":2}This can be helpful when you want to group, filter, or analyze QR Codes based on attributes relevant to your internal systems.
Supported metadata format
The metadata field accepts a JSON object.
Required format:
Flat JSON key–value pairs
Keys: string-type
Values: primitive types (
stringornumber)
Note: Keeping metadata flat makes it easier to query, filter, and export.
Adding metadata to a QR Code
Sign in to your Uniqode account
While creating or editing a QR Code, go to Step 3 Customize
Go to the Metadata section and enter the key–value pairs in their respective fields
Click Next and then click Finish to save the changes
On the QR Code detail page
You can:
View metadata in a formatted, readable layout
Edit or replace metadata using a JSON editor
Clear metadata with confirmation
Managing metadata in bulk
If you’re working with a large number of QR Codes, you can modify metadata in bulk using supported bulk tools.
You can:
Set metadata on multiple QR Codes
Replace metadata entirely for each selected QR
Clear all existing metadata in one action
Note: Review the bulk changes before finalizing them to avoid accidental overwrites.
Managing metadata via API
You can manage metadata on individual QR Codes using the API. The following actions are supported:
1. Set metadata
Add metadata when creating a new QR Code.
2. Update metadata
Modify or add new key–value pairs on an existing QR Code. Only the keys you specify will be updated.
3. Clear metadata
Remove all metadata from a QR Code. This is useful when you want to reset or repurpose it.
Best practice:
Use clear, consistent key names (such as campaign, segment, or owner_id) to keep metadata predictable across systems.
Tips for using metadata effectively
Use metadata for attributes you expect to use in filters, analytics, or automation.
Avoid storing sensitive personal data.
Keep key names consistent across teams and projects.
Stick to flat keys unless nested JSON becomes officially supported.
Validate JSON before saving to prevent malformed data.