> For the complete documentation index, see [llms.txt](https://docs.gridmate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gridmate.io/product-tour/file-explorer.md).

# File Explorer

Browse, preview and manage the files related to a record, with upload and download controls.

GridMate provides a lightning component **GM - File Explorer** to display the list of files related to a specific record.

In this tutorial, we will configure **GM - File Explorer**.

{% stepper %}
{% step %}

### Open the page

Select an account record and edit the page in the Lightning App Builder.
{% endstep %}

{% step %}

### Add the component

From the components list, search for GM - File Explorer. The grid component is now ready for configuration in the Lightning App Builder.
{% endstep %}

{% step %}

### Configure the properties

The property values can be configured to tailor the component to the needs of the end-user. To perform a quick configuration, populate the property values in the table below.
{% endstep %}
{% endstepper %}

## Properties

| Property          | Demo value  | Notes |
| ----------------- | ----------- | ----- |
| Default View      | **table**   |       |
| Enable Delete     | **Checked** |       |
| Enable Copy/Paste | **Checked** |       |
| Show Border       | **Checked** |       |

Below is a step by step tutorial to configure the **GM - File Explorer**.

{% embed url="<https://youtu.be/j2SdIxEMozQ>" %}
**GM - File Explorer**
{% endembed %}

## Search By Topic

This feature enhances the search process by delivering precise and targeted results that align with users' specific interests and information needs.

{% embed url="<https://youtu.be/p6j08F_iFnw>" %}
Search By Topic
{% endembed %}

## Disable Upload

This configuration option blocks direct file uploads to Salesforce Files, supporting centralized storage management and policy enforcement.

To **Disable Upload** properties.

1. Edit the Lightning page in the App Builder.
2. Scroll down until you locate the **Disable Salesforce Upload** setting, then check it.

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2FPvkYygwKGubhzueVTovm%2FScreenshot%202026-02-24%20at%2012.03.38.png?alt=media&amp;token=18e13888-773a-409b-8d7d-6bea4b5cf9ab" alt=""><figcaption></figcaption></figure>

Below is a step by step tutorial to **Disable Upload** feature 👇.

{% embed url="<https://youtu.be/n_XIwrt6rFc>" %}

## Disable Download

This feature strengthens data protection by restricting file downloads, ensuring that files remain within approved storage environments.

To **Disable Download** properties.

1. Edit the Lightning page in the **App Builder**.
2. Scroll down until you locate the **Disable Download** section, then check it.

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2FKEHbOQLKvfEmZKUog30D%2FScreenshot%202026-02-24%20at%2012.03.38%202.png?alt=media&amp;token=10192550-8998-4bfe-a104-ce9ba5738ebc" alt=""><figcaption></figcaption></figure>

Below is a step by step tutorial to **Disable Download** feature 👇.

{% embed url="<https://youtu.be/n_XIwrt6rFc?si=Lwohn0Er_o1UDi36&t=50>" %}

## Enhanced Preview

This feature improves the file preview experience by delivering higher rendering quality and intuitive navigation controls, including zoom in, zoom out, and rotation for better document inspection.

To Enable **Enhanced Preview**.

1. Edit the Lightning page in the App Builder.
2. Scroll down until you locate the Enable **Enhanced Preview** setting, then check it.

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2FVKrDoOwzSjKrxez4CFVJ%2FScreenshot%202026-02-24%20at%2022.09.24%202.png?alt=media&amp;token=2b0d9df1-e1c3-474c-b520-7bae34dbdd58" alt=""><figcaption></figcaption></figure>

Below is a step-by-step tutorial on how to use the **Enhanced Preview** feature 👇

{% embed url="<https://www.youtube.com/watch?v=a2ycU7VMAs4>" %}

## Inline Preview

This feature allows users to preview file contents directly within the **File Explorer** interface, eliminating the need to open a separate modal and enabling a more efficient in-context viewing experience.

{% hint style="info" %}
When selecting **Top** or **Bottom** alignment, configure the **Inline Preview Height(px)** to adjust the vertical space of the preview panel.

When selecting **Left** or **Right** alignment, the layout switches to horizontal mode, allowing you to define the **Inline Preview Width(px)** instead.
{% endhint %}

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2FvqhnZNMOyktC2kdJt9QA%2FScreenshot%202026-02-24%20at%2022.09.24.png?alt=media&amp;token=3cba4515-2dca-47ab-9515-a7a527039d9e" alt=""><figcaption></figcaption></figure>

Below is a step-by-step tutorial on how to use the **Inline Preview** feature 👇

{% embed url="<https://youtu.be/a2ycU7VMAs4?si=7Cxtcvqoekg_7GpA&t=78>" %}

## Add Compact View

Controls which columns appear in the File Explorer's List and Tree views.\
Available on both the record-page and the app/home-page configurations.

{% hint style="info" %}
Enter a comma-separated list of column keys. Leave blank to show all columns.
{% endhint %}

By default, the Files Explorer shows every configured column.

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2F3G4picSG7WNS7WCRmSRb%2FScreenshot%202026-09-23%20at%201.49.44%E2%80%AFPM.png?alt=media&amp;token=79b27f32-9ccf-41c1-b8e5-3957eab00aa8" alt=""><figcaption></figcaption></figure>

Enter `title,uploadedBy` and the same nine files are shown in a trimmed-down grid: File Name and Uploaded By only, with tighter rows.

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2F5M5uU7vdwWXOrC3ztStm%2FScreenshot%202026-09-23%20at%201.51.45%E2%80%AFPM.png?alt=media&amp;token=d72a0468-046e-4fff-8a56-f5dbb6dc8404" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Compact View only affects display. No files are hidden, and the record\
count in the header still reflects the full list.
{% endhint %}

## Next steps

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>GM - File Explorer</strong></td><td>Every property of the component.</td><td><a href="https://docs.gridmate.io/package-reference/components-library/files/gm-file-explorer.md">GM - File Explorer</a></td></tr><tr><td><strong>File Explorer - File Connect</strong></td><td>Add files from Google Drive, Amazon S3 and SharePoint, and attach folders.</td><td><a href="https://docs.gridmate.io/advanced-guides/other-components/file-explorer-file-connect.md">File Explorer - File Connect</a></td></tr><tr><td><strong>File Explorer - File Operations</strong></td><td>Automate file management from Salesforce Flow.</td><td><a href="https://docs.gridmate.io/advanced-guides/other-components/file-explorer-file-operations.md">File Explorer - File Operations</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.gridmate.io/product-tour/file-explorer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
