Compass CRUD and Documents Tab
Parent: MongoDB Compass · Published reference · snapshot 2026-10-23 · skill mongodb-cohort-b63ded16c61f
↓ Facts as markdownall context files
Source-anchored research for Compass CRUD and Documents Tab. Run status: COMPLETED.
These notes link each claim to its source. Some citations identify archived research reports that are no longer hosted on this site. A published reference means the content is available; it does not certify independent review or accuracy.Read the editorial policy and follow the sources before relying on a claim.
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]
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]
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]
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]
- 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]
- The JSON insertion editor accepts an array of documents for inserting several records at once. (low confidence) [source]
- 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]
- List and Table editing use findOneAndUpdate to update changed fields; JSON editing uses findOneAndReplace to replace the document. (high confidence) [source]
- 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]
- 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]
- 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]
- 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]
- 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]
- The Documents tab supports browsing, insertion, editing, cloning, and deletion of collection documents through a graphical interface. (high confidence) [source]
- 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]
- The query bar filters displayed documents, and Options exposes additional query settings. (medium confidence) [source]
- 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]
- Hovering over a document exposes the pencil control. Editing can change field names, values, and types; Update saves the changes. (high confidence) [source]
- 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]
- 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]
- 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]
- 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]
Children
- No children recorded.