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.

The subscription trial banner now appears only in the last 7 days before accessUntil.

If you are earlier than that window, the banner stays hidden until the trial is closer to expiration.

Inventory session issues

Session has no items

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

Start Session does not fire from a stale page state

If the session detail page has been open for a while, refresh it before starting the session so the cached session state matches the backend. The start action now relies on the session endpoint response instead of blocking on cached active-session state.

Export/report download not immediate

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

QR scanning issues

Camera scanner does not open

Fix: use the browser permission prompt to allow camera access, or paste the asset tag or QR URL into the scanner modal. The scanner now tries the environment camera first, then the built-in camera, and then the browser default. If it still fails, the UI shows the browser error name and message so you can tell permission denial from device access problems.

The asset scanner modal now includes a short helper line that reminds users it accepts a QR code, asset URL, or asset tag.

When multiple camera sources are available, use the camera source picker in the scanner UI to switch between built-in cameras, external readers, and Continuity/iPhone cameras.

On iPhone and iPad, the picker now simplifies the list to Automatic, Front camera, and Back camera so you do not have to choose between individual rear lenses.

The live camera preview also fills the scan frame on mobile browsers instead of sitting inside a smaller inner box.

External QR reader opens the label URL while signed out

Fix: sign in as normal. InvyMate stores the destination and returns you to the asset detail page after authentication.