Configuration
Configure Better Files and Better Files React using record-page properties and the shared File Related List Config metadata, including the React theme.
On this page
Where settings live
Both components use two configuration locations:
- Custom Metadata → File Related List Config → Default controls View All columns, filter mode, and the Better Files React theme for the org. Both components use this same record.
- Lightning App Builder controls uploads, thumbnails, file counts, email inclusion, and minimum file size for each record-page component instance.
Record-page settings
Open your record page in Lightning App Builder, then select Better Files or Better Files React to edit its properties. Save the page when you finish. The labels differ between components:
| Better Files | Better Files React | What it does |
|---|---|---|
| Accepted File Formats | Accepted file formats | Sets comma-separated upload extensions, such as .pdf,.docx,.png. |
| Allow multiple file uploads at once | Allow multiple file uploads | Allows several files in one upload selection. |
| Show preview of files | Show file thumbnails | Shows available thumbnails on the record-page card. |
| How many files are displayed on the record page | Number of files displayed | Limits files on the card. Open View All for the full list. |
| How many files per row | Files per row | Controls the card grid. Narrow regions may stack files vertically. |
| Show Email Message Attachments | Include email attachments | Includes eligible files from related emails. |
| Minimum file size (KB) | Minimum file size (KB) | Excludes smaller files from the card and View All. Use 0 for no minimum. |
Available properties depend on the installed package version. Accepted formats apply to new uploads, not existing files in the list. For React, narrow the supplied extension list as needed; adding an extension does not expand the upload service’s supported formats.
React allows 1–100 files displayed and 1–11 files per row, with defaults of 6 and 3 respectively.
Email attachments
Enable Show Email Message Attachments in Better Files or Include email attachments in Better Files React. Both include files linked to related email messages and carry the setting through to View All.
The email must be related to the record, and the user must be able to access its files. An attachment on an unrelated email will not appear just because its sender is associated with the record.
View All columns
Both components read the shared File Related List Config record for View All columns:
- Open Setup → Custom Metadata Types.
- Find File Related List Config and select Manage Records.
- Edit the Default record.
- Choose whether to show Owner, Last Modified Date, Last Modified By, and File Size.
Changes apply to both components across the org. Title and row actions remain visible. The original component’s App Builder settings marked Deprecated no longer control these columns; use Custom Metadata instead.
File type filters
The Filter Mode setting in File Related List Config controls the filter in View All:
- Basic offers broad categories such as Images and Documents.
- Advanced offers the file extensions present on the record, such as PDF or PNG.
Choose All files to clear the file-type filter. Search, minimum file size, email inclusion, and Salesforce access still apply.
React theme
The Theme setting in File Related List Config controls how Better Files React looks across the org:
-
Cosmos follows Salesforce’s Cosmos theme. This is the default.

-
Lightning Blue follows Salesforce’s Lightning Blue theme.

-
Better Files keeps the original Better Files React design.

To change it, edit the Default record as described in View All columns, choose a Theme, and save. A blank value uses Cosmos. Reload open record pages to see the change.
The theme applies to the record-page card, View All, and their dialogs, menus, and toasts. It does not change the original Better Files component. Lightning App Builder has no theme property, and Better Files React does not follow your org’s Salesforce theme automatically, so choose the value that matches it.
After an upgrade
Themes are available in Better Files 2.2 and later. Upgrading switches existing Better Files React components to Cosmos. To keep the previous look, set Theme to Better Files.
An upgrade may not add Theme to the Default record’s edit page. If the field is missing:
- Open Setup → Custom Metadata Types and select File Related List Config.
- Under Page Layouts, edit File Related List Config Layout.
- Drag Theme onto the layout and save.
React application discovery
Better Files React discovers the installed Salesforce application automatically. It does not require a manually configured React URL. If an older installation exposes a React App URL field, that legacy field is ignored by the current implementation.