Troubleshooting

Common issues and the fastest fixes.

CSV import issues

“Required fields not mapped”

Fix: map the required fields in the column mapping step.

Assets require: name, category, location
People require: fullName, email

Category/location not recognized

Fix: normalize names in your CSV to match what exists in Configuration:

create missing categories/locations first, or
update CSV values to match exactly.

Duplicate emails (people import)

Fix: de-duplicate the file and decide how you want duplicates handled.

Plan/limit issues

“Export is missing”

Export is plan-gated (Team/Pro) and may be hidden when locked.

Fix: upgrade to a plan that includes export, or confirm the feature is enabled in your plan configuration.

“Add New Item / Import disabled”

This typically happens when the asset limit is reached.

Fix: upgrade plan or remove assets.

Trial expired but tenant still shows `trialing`

Trial access is enforced by accessUntil. InvyMate now runs an automatic sweep every 10 minutes that moves expired trialing tenants to suspended.

If status still appears stale, wait one sweep interval and refresh the tenant details.

Inventory session issues

Session has no items

If a session is still scheduled, the expected list is generated when you click Start.

Export/report download not immediate

Reports are prepared asynchronously. Watch for notifications indicating the file is ready.