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