<!-- llms-explorer concept facts · https://llms-explorer.com/tree/compass-crud-and-documents-tab/ · pack 2026-10-23 · ~1509 tokens -->

# Compass CRUD and Documents Tab

> Source-anchored research for Compass CRUD and Documents Tab. Run status: COMPLETED.

Parent: [MongoDB Compass](https://llms-explorer.com/tree/mongodb-compass/) · 4 facets · 22 facts · page: https://llms-explorer.com/tree/compass-crud-and-documents-tab/

## How it works

- The documented insertion modes are Shell Syntax, Extended JSON, and Field-by-Field. Field-by-Field accepts one document at a time; the text modes accept arrays. Compass generates an ObjectId when _id is omitted. (low confidence) (verified as of 2026-10-14) — [source](https://www.mongodb.com/docs/compass/documents/insert.md)

## How-to and procedures

- Use Add Data > Insert Document to create documents. JSON mode can insert an array of documents, so file import is not the only way to insert multiple records. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents/insert.md)

## Problems, failure modes and limitations

- Compass documents conflict detection for fields modified outside Compass: the user can cancel or proceed with replacement after the warning. (low confidence) — [source](https://www.mongodb.com/docs/compass/documents/modify.md)

## Facts and statements

- The Documents tab supports browsing, inserting, editing, cloning and deleting collection documents; its query bar filters the documents displayed. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents.md)
- Documents can be viewed as List, JSON or Table; insertion is available through Add Data > Insert Document, with JSON and field-by-field editors. (high confidence) — [source](https://blogs.bmc.com/mongodb-compass/)
- The JSON insertion editor accepts an array of documents for inserting several records at once. (low confidence) — [source](https://www.red-gate.com/simple-talk/featured/working-with-documents-in-the-mongodb-compass-gui/)
- Clone Document opens a new insertion dialog populated from an existing document, so users can adapt its fields and values before inserting a separate record. (high confidence) — [source](https://blogs.bmc.com/mongodb-compass/)
- List and Table editing use findOneAndUpdate to update changed fields; JSON editing uses findOneAndReplace to replace the document. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents/modify.md)
- Bulk update uses the Documents query filter and accepts updateMany update syntax. Its modal does not accept options such as upsert, writeConcern or collation, and document previews require a database configured to support transactions. (low confidence) — [source](https://www.mongodb.com/docs/compass/documents/modify-multiple.md)
- Bulk deletion applies the query filter, previews matching documents and requires confirmation. Leaving the query bar blank targets all documents in the collection; deletion is permanent. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents/delete-multiple.md)
- The readOnly setting hides write UI controls but does not remove the connected user’s shell privileges. Enforce read-only access with the database read role. (low confidence) (verified as of 2026-10-14) — [source](https://www.mongodb.com/docs/compass/editions.md)
- COMPASS-5528 reported that editing a field inside an array of subdocuments replaced the whole array in Compass 1.30.1. The ticket records the bug as fixed in 1.32.4; it is historical evidence, not evidence that current versions still behave this way. (low confidence) — [source](https://jira.mongodb.org/browse/COMPASS-5528)
- COMPASS-8337 reported that JSON replacement in Compass 1.44.4 silently converted integer-valued Double fields to Int32. The ticket records a fix in 1.46.7. (low confidence) — [source](https://jira.mongodb.org/browse/COMPASS-8337)
- The Documents tab supports browsing, insertion, editing, cloning, and deletion of collection documents through a graphical interface. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents.md)
- List view presents expandable document fields, Table view aligns fields in columns, and JSON view displays document representations; MongoDB documents Extended JSON handling for BSON types. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents/view.md)
- The query bar filters displayed documents, and Options exposes additional query settings. (medium confidence) — [source](https://www.mongodb.com/docs/compass/documents.md)
- MongoDB documents a default page size of 25 and selectable sizes of 25, 50, 75, or 100. The selected size persists across tabs and restarts. (high confidence) (verified as of 2026-10-14) — [source](https://www.mongodb.com/docs/compass/documents/view.md)
- Hovering over a document exposes the pencil control. Editing can change field names, values, and types; Update saves the changes. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents/modify.md)
- For List/Table edits, Compass warns if a changed field was also modified outside Compass; the user may cancel or proceed with replacement. (low confidence) — [source](https://www.mongodb.com/docs/compass/documents/modify.md)
- Bulk update uses the query-bar filter to select documents and accepts updateMany-style update expressions; leaving the filter blank targets the whole collection. (high confidence) — [source](https://www.mongodb.com/docs/compass/documents/modify-multiple.md)
- The Update Documents modal does not accept options such as upsert, writeConcern, or collation. Its affected-document previews require a database configured to support transactions. (low confidence) (verified as of 2026-10-14) — [source](https://www.mongodb.com/docs/compass/documents/modify-multiple.md)
- If insertion or modification is unavailable, check whether Compass is operating read-only and whether the database user has write access. MongoDB describes combining database read privileges with Compass's readOnly setting for read-only use. (medium confidence) — [source](https://www.mongodb.com/docs/compass/documents/insert.md)
