Error Reference

Error Reference

Common errors you may encounter with Mtrix and how to resolve them:

Initialization Errors

Error Code
Message
Cause
Solution

INIT_001

"Mtrix: organizationId is required"

Missing organization ID

Provide a valid organization ID in your init call

INIT_002

"Mtrix: projectId is required"

Missing project ID

Provide a valid project ID in your init call

INIT_003

"Mtrix: Already initialized"

Multiple initialization attempts

Only call mtrix.init() once

INIT_004

"Mtrix: Invalid environment"

Environment value not recognized

Use 'production', 'staging', or 'development'

INIT_005

"Mtrix: Browser not supported"

Browser lacks required capabilities

Check browser compatibility or add polyfills

Authentication Errors

Error Code
Message
Cause
Solution

AUTH_001

"Invalid organization ID"

Organization ID doesn't exist

Verify ID in dashboard settings

AUTH_002

"Invalid project ID"

Project ID doesn't exist

Verify ID in dashboard settings

AUTH_003

"Project not active"

Project has been disabled

Activate the project in dashboard

AUTH_004

"Environment not allowed"

Environment restrictions in place

Check allowed environments in settings

AUTH_005

"Domain not allowed"

Domain restrictions in place

Add current domain to allowed domains

Tracking Errors

Error Code
Message
Cause
Solution

TRACK_001

"Invalid event name"

Event name missing or invalid

Provide the event name as string

TRACK_002

"Invalid properties"

Properties not an object

Ensure properties is an object

Experiment Errors

Error Code
Message
Cause
Solution

EXP_001

"No Experiment found"

No active experiments found in the project

Verify experiment statuses

EXP_002

"Audience not matching"

User is not falling under the target audience

--

EXP_003

"Experiment error"

Generic experiment error

Check experiment configuration

Last updated