How do I correctly format and upload a CSV to update User-specific tags?

If you are experiencing issues with CSV uploads (such as pending status, errors, or tags not updating), please check the following configurations:

1. Match Data Types

Ensure that the data in your CSV columns matches the Tag Type defined in the system settings. A common error is attempting to upload incorrect formats, such as putting an integer (e.g., 20000) into a field defined as a Date tag.

2. Use the Correct Date Format

When updating tags of type Date, the system expects the following format: YYYY-MM-DD HH:MM:SS * Example: 2026-01-01 14:00:00

3. Select the Correct Identifier (UserID vs. HWID)

User-specific tags are tied to a UserID and are inherited by all devices associated with that user. They cannot be updated by Hardware ID (HWID). * Ensure your CSV contains a column for UserID. * During the import mapping step, select UserID as the primary key/identifier.

4. Remove Empty Rows

Excessive empty rows at the bottom of a CSV file (often appearing as sequences of commas in a text editor) can cause processing delays or pending uploads. Open your file in a plain text editor and delete any trailing empty lines.