> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

<!--
Tab options on this page. Append to the .md URL to filter:
  ?tabs=<id,...>   select specific tabs (e.g. ?tabs=nodejs,shell)
  ?allTabs=true    include every tab
  (no param)       default: one tab per tabset

Available tabs:
  other tabs: list-view, json, table-view
-->

# View Documents in Compass

MongoDB Compass Readonly Edition will be deprecated in a future release. To replicate the read-only behavior in a standard Compass edition, assign users [`read`](https://www.mongodb.com/docs/manual/reference/built-in-roles.md#mongodb-authrole-read) access at the database level and enable the [readOnly](https://www.mongodb.com/docs/compass/settings/read-only.md#std-label-compass-read-only) option in Compass.

The Documents tab provides three ways to access documents:

List View

The default document view. Documents are shown as individual members of a list. In this view you can easily expand embedded objects and arrays.

JSON View

Documents are shown as properly-formatted JSON objects. In this view Compass uses extended JSON to display the data types of fields where appropriate.

Table View

Shows documents as rows of a table, with document fields shown in the table columns. With this view, you can more easily see which documents contain specific field values.

Use the View buttons to select which view is shown in the following examples:

### List View

![Documents list view](/images/compass/documents-list.svg)

By default, the Documents tab in Compass displays 25 documents at a time. To change the number of displayed documents per page, open the drop-down menu under the query bar and select one of the following values:

- 25

- 50

- 75

- 100

![Documents per page selector](/images/compass/documents-per-page.png)

**Note:**

If you change the number of documents displayed per page, Compass saves the new value as the new default, including when you open the Documents view in a new tab or after you restart Compass.

## Expand Embedded Objects and Arrays

To expand all objects in all documents in your collection in List View or JSON View, you can right-click the query bar or its surrounding whitespace. Then, select Expand all documents from the drop-down menu.

Alternatively, you can open the drop-down arrow next to view selector and click Expand all documents.

![Drop-down menu to expand documents](/images/compass/expand-all-documents.png)

### Expand Individual Documents

To expand individual documents, follow the instructions below.

### List View

To toggle the expansion of embedded objects and array elements, hover over the target document and click the arrow in the top-left corner.

![Expand embedded objects list](/images/compass/expand-doc-list-view.svg)

Alternatively, you can right-click on the document you want to expand and select Expand all fields from the drop-down menu.

## Copy Documents to Clipboard

### List View

To copy a document to your clipboard, hover over the document and click the Copy icon:

![Copy Document from List View](/images/compass/copy-doc-list-view.svg)

You can also right-click on the document and select Copy
document from the drop-down menu.

Additionally, if you right-click a specific field or value, you can copy that field/value pair by selecting Copy
field & value from the drop-down menu.

## Encrypted Fields

### List View

Compass obscures document fields encrypted with Field-Level Encryption (FLE). Compass displays the values of these fields as a series of asterisks.

![Encrypted field in list view](/images/compass/encrypted-fields-list.png)

If your deployment is connected using In-Use Encryption and your collection is configured with [Queryable Encryption](https://www.mongodb.com/docs/manual/core/queryable-encryption.md#std-label-qe-manual-feature-qe), you can toggle the In-Use Encryption connection option.

- When In-Use Encryption is enabled, you can modify and view the encrypted values and fields.

- When In-Use Encryption is disabled, Compass displays the values of these fields as a series of asterisks.

## View URLs in Browser

If your document contains a URL value, you can right-click the URL and select Open URL in browser to open the URL in your browser:

![Right click to Open URL](/images/compass/right-click-open-url.png)