payloadcms/payload
Documented errors, page 2 of 3. Back to payloadcms/payload
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| The collection with slug | http | error | local-api, collection, slug, versions, configuration |
| The collection with slug | http | error | local-api, collection, slug, find-distinct, configuration |
| Collection with the slug | http | error | db-mongodb, query, relationship, api-error |
| Username is required. | exception | error | auth, login, validation, username |
| Staged upload not found. Complete the upload action first… | validation | error | mcp, file-upload, upload-reference, azure, gcs, validation |
| A valid amount is required to initiate a payment. | exception | error | stripe, amount, validation, cart, ecommerce |
| The collection with slug | http | error | local-api, collection, slug, duplicate, configuration |
| The provided URL is not allowed. | http | error | upload, paste-url, security, allow-list, validation |
| A user with the given username is already registered. | validation | error | auth, register, validation, username, duplicate |
| Assertion for DB name of | http | error | mongodb, config, db-name, slug |
| Invalid field path. | validation | error | validation, arrays, security, plugin-import-export |
| Currency must be provided for product validation. | exception | error | validation, currency, ecommerce, product, input-contract |
| Failed to initialize multipart upload | exception | error | r2-storage, upload, client, network, multipart |
| Join fields cannot be added to arrays, blocks or globals. | exception | error | join, array, block, global, config, schema, sanitization |
| Stripe secret key is required. | exception | critical | stripe, config, secrets, env, ecommerce |
| Document with ID is currently locked by another user and… | exception | warning | locking, concurrency, document, admin |
| Cannot findDistinct by a virtual field that isn't linked to… | http | warning | distinct, virtual-fields, config |
| The collection with slug | http | error | local-api, collection, slug, create, configuration |
| Invalid filename. | http | error | upload, security, path-traversal, filesystem |
| The collection with slug | http | error | local-api, collection, slug, update, configuration |
| Migration aborted: version._status field not found or has… | exception | error | db-mongodb, migration, localization, data-integrity, versions |
| Virtual field in ` : `collection `} references 2 or more… | exception | error | virtual, relationship, config, schema, sanitization |
| Failed to retrieve array of joins for | http | error | mongodb, joins, config, typo |
| Forbidden | http | error | tanstack-start, server-adapter, forbidden, access-control, framework |
| Missing ID of version to restore. | http | error | local-api, restore-version, validation, bad-request |
| The collection with slug | http | error | local-api, collection, slug, delete, configuration |
| Cart is empty or not provided. | exception | error | stripe, cart, validation, ecommerce, checkout |
| Failed to download | exception | error | network, create-payload-app, fetch, cli |
| Task not found in workflow | exception | error | jobs, workflows, tasks, configuration |
| Locales must be defined for locale columns | exception | error | sqlite, codegen, enum, localization, tooling |
| Invalid file url | http | error | upload, type-validation, external-file, data-integrity |
| Relationship field was not found | http | error | db-mongodb, query, join, relationship, config, api-error |
| Currency is required. | exception | error | stripe, validation, currency, ecommerce, input-contract |
| Unauthorized | exception | error | auth, dashboard, server-functions, unauthorized |
| Variant with ID does not have a price in . | exception | error | validation, variant, price, currency, ecommerce, data-integrity |
| Cannot find field for path at | http | error | query, field-resolution, config-lookup, where |
| Column for compound index on was not found in the table. | http | error | schema, index, configuration |
| Import document not found | exception | error | jobs, import, plugin-import-export |
| Task with slug in workflow does not have a valid handler. | exception | error | jobs, tasks, handler, configuration |
| A valid customer email is required to make a purchase. | exception | error | stripe, validation, customer, ecommerce, input-contract |
| Uploaded file size does not match the expected size. | exception | error | upload, staged-upload, size-mismatch, validation |
| Collection " " is not a hierarchy | exception | error | hierarchy, config, validation |
| Could not find target field at schemaPath | exception | error | ui, server-function, fields, schema, render |
| Error: cannot connect to SQLite | exception | critical | db-d1-sqlite, database, cloudflare, connection, adapter |
| Missing . | exception | error | auth, unlock, validation, bad-request |
| Error: cannot connect to Postgres | exception | critical | postgres, connection, startup, network, config |
| Hierarchy parent field | exception | error | hierarchy, config, sanitization, fields, relationship |
| Task slug " " is already used by a workflow. No tasks are… | exception | critical | jobs, queues, configuration, startup |
| Unique is not supported in Postgres for hasMany text fields. | http | error | schema, unique, hasmany, text, postgres |
| Error: missing secret key. A secret key is needed to secure… | exception | critical | security, configuration, secret, startup |
| Failed to create new | http | error | stripe, webhook, sync, create, configuration |
| Unable to retrieve file: missing filename or url | exception | error | storage, file-upload, import, plugin-import-export |
| not found | exception | error | migration, sqlite, localization, configuration |
| Localization is not enabled in payload config | exception | error | migrations, localization, config, predefined-migration |
| The collection with slug | http | error | local-api, collection, slug, find, configuration |
| Hierarchy parent field | exception | error | hierarchy, config, sanitization, fields, relationship |
| Invalid staged upload. | exception | error | upload, staged-upload, validation, api-contract |
| RichText field " " is missing the editor prop. For… | exception | error | richtext, editor, config, sanitization, lexical, block |
| Fields are not initialized. | http | error | mongodb, internal, config, query |
| Collection slug already in use | http | critical | config, collections, sanitize, duplicate, buildconfig |
| Upload collection was not found | http | error | upload, api, config, staged-upload, validation |
| Network response was not ok | exception | error | json, json-schema, network, fetch, validation, runtime |
| A file name is required. | exception | error | upload, multipart, json, api-contract |
| A field with the name | exception | error | field-name, duplicate, config, schema, sanitization |
| Error: the payload config is required for getPayload to… | exception | critical | local-api, configuration, startup |
| Error: the payload config is required to initialize payload. | exception | critical | initialization, configuration, startup |
| The collection with slug | http | error | local-api, collection, slug, versions, restore, configuration |
| Missing ID of document to update. | http | error | collections, update, local-api, validation, rest-api |
| Search failed | exception | error | ui, hierarchy, relationship, search, network, client |
| Could not find " " in the fieldSchemaMap | exception | error | ui, form-state, schema, fields, config |
| The hierarchy title field | exception | error | hierarchy, config, use-as-title, fields, validation |
| No package.json found in this project | exception | error | create-payload-app, cli, config, package-json |
| Invalid path segment. Only alphanumeric characters and… | http | error | query, security, injection, path, validation |
| The collection with slug | http | error | local-api, collection, slug, versions, configuration |
| Either collectionSlug or globalSlug must be provided | exception | error | migrations, localization, argument-validation, predefined-migration |
| Email is required. | exception | error | auth, login, validation, email |
| ERROR: Failed to retrieve collection model with the slug | http | error | mongodb, models, collections, init |
| MCP overrideAccess is only available in development. | http | error | security, mcp, config, env, plugin-mcp |
| Join Model was not found for | http | error | mongodb, joins, models, init |
| Error: cannot connect to MongoDB | exception | critical | db-mongodb, database, connection, network, adapter |
| error:notAllowedToPerformAction | exception | error | auth, refresh, jwt, middleware |
| Failed to upload part | exception | error | r2-storage, upload, client, network, multipart, retry |
| The folder " " contains that still belong to the following… | http | error | hierarchy, folders, validation, before-validate, api-error-400 |
| Attachment is missing filename | validation | error | email, resend, attachments, validation |
| The collection with slug | http | error | local-api, collection, slug, versions, configuration |
| Invalid or expired staged upload. | exception | error | upload, staged-upload, jwt, expired, secret |
| Could not find ExportDefaultDeclaration in next.config.js | exception | error | create-payload-app, nextjs, ast, config, esm |
| File data must be valid base64. | validation | error | mcp, file-upload, base64, validation |
| Collection has disabled bulk delete | http | error | delete, access-control, config, bulk-operations |
| Collection " " does not support file uploads. | validation | error | mcp, file-upload, configuration, collection-config |
| Field has invalid name ' '. Field names can not include… | exception | error | field-name, config, schema, sanitization, query |
| File exceeds the byte upload limit. | validation | error | mcp, file-upload, size-limit, configuration |
| Collection config not found for | exception | error | config, jobs, import, plugin-import-export |
| Too many redirects. | http | error | upload, paste-url, network, redirects |
| This collection is not an upload collection | http | error | upload, api, config, routing |
| Token is either invalid or has expired. | exception | error | auth, reset-password, token, expired |
| Cannot provide both collectionSlug and globalSlug | exception | error | migrations, localization, argument-validation, predefined-migration |
| There was an error deleting file. | http | error | upload, filesystem, delete, permissions |
| Could not retrieve sanitized polymorphic joins config for | http | error | mongodb, joins, polymorphic, config, sanitization |
| Argument 'stripeArgs' must be an array. | validation | error | stripe, rest, validation, api-contract |