File Manager Preferences

Our built-in File Manager is designed with a set of smart, predefined behavior options to ensure a seamless and intuitive user experience right out of the box.

That said, we understand that every workflow is unique. That’s why we’ve made it easy for you to customize File Manager settings to better suit your specific needs and preferences.

How to Set Your Preferences

To start customizing, simply include a fileManagerPreferences object inside your TOPOL_OPTIONS configuration. All your custom settings go inside this object.

 fileManagerPreferences: {
   // your custom options here
},

Set Default File View (List or Tiles)

When you open the File Manager, it shows your files (folders and images) in a List view by default. You can switch between List view and Tiles view manually using the buttons in the top-right corner of the File Manager:

The default view is set to List view. If you'd prefer to see the Tiles view first by default, specify the defaultTilesView option in the fileManagerPreferences object and set it to true.

 fileManagerPreferences: {
  defaultTilesView: true, // true = tiles view, false = list view
},

Hide Pexels Integration

By default, the File Manager comes with a built-in integration to Pexels, a free stock photo library. This integration allows users to search and add high-quality images directly from within the editor.

If you'd like to hide this integration, specify the hidePexelsIntegration option in the fileManagerPreferences object and set it to true.

 fileManagerPreferences: {
  hidePexelsIntegration: true, // true = hide, false = show
},

Limit the Number of Files Uploaded at Once

By default, users can select and upload an unlimited number of files at once through the File Manager. In some cases — for example, when your backend proxies storage requests to a service with rate limits — bulk uploads can cause issues.

The maxUploadingFiles option lets you set a hard cap on how many files can be uploaded in a single batch. When a user selects more files than the allowed limit, only the first N files are uploaded and a notification is shown informing the user that the limit was reached.

To enable this, specify the maxUploadingFiles option in the fileManagerPreferences object and set it to a positive integer:

 fileManagerPreferences: {
  maxUploadingFiles: 5, // allow up to 5 files per upload
},

Example — restrict to single-file uploads:

 fileManagerPreferences: {
  maxUploadingFiles: 1, // only one file can be uploaded at a time
},

When maxUploadingFiles is set to 1, the file picker automatically switches to single-file selection mode, so users cannot select multiple files in the browser dialog.

When maxUploadingFiles is set to 2 or higher, the file picker remains in multi-select mode, but only the allowed number of files is uploaded. If the limit is exceeded, the user sees a notification like:

"Only 5 out of 12 files were uploaded due to the upload limit."