File Picker

Merge's File Picker is built into our embedded Merge Link component and provides a user-friendly interface for your customers to browse Files, Folders, and/or Drives in their connected File Storage account. File Picker does not impact your File Storage Linked Account syncs unlike Selective Sync.

Demo video
Watch this quick video to learn the basics of how Merge's File Picker works.
...Loading
Setting up Merge Link with File Picker

To set up File Picker, please follow our Embedded Link guide to add our drop-in Merge Link component to your app.

Make sure you have the latest version of react-merge-link

Enabling the File Picker only requires a few additions to step 2.

In addition to following step 2 of our Embedded Link guide, you will need to add a new parameter filePickerConfig.

onSubmit is the only required input to filePickerConfig, and returns an array of selected objects from your user's workspace.

This input is a callback and is left as console.log() in this example for you to decide how to handle Files, Folders, and Drives that your users have selected in the File Picker. If you are testing the File Picker in your dashboard, no callback is provided and the File Picker will automatically close on submit.

In this example, the File Picker configuration allows multi-select of Files and Folders.

See details about each filePickerConfig input below.

Configuration inputs
InputTypeDescription
typesArray

Optional array of object types that determines which types of objects your users can pick.

Possible values for object types include: FILE, FOLDER, DRIVE.

If types is empty, your users will be able to pick objects of any type. If types is not empty, your users are restricted to selecting from the object types in the array.

For example, if types = ['FILE', 'FOLDER'], your users will be able to select Files and Folders, but not Drives.

allowMultiSelectBoolean

Optional boolean field that allows your users to select multiple objects in one File Picker session.

The default value is false, which restricts your users to only select one object.

onSubmitFunction

Callback that returns an array of MergeFileStorageData objects as its output.

See an example for MergeFileStorageData below.

Merge File Storage data

MergeFileStorageData properties should match our File Storage Common Model properties for the given workspace object type.

Select the object type to see its corresponding properties and example response.

File

Folder

Drive

The File object is used to represent a file in the workspace. The Object typically exists under a folder or drive, if it exists.
Properties
idUUID
remote_idString
The third-party API ID of the matching object.
created_atDateTime (ISO 8601)
The datetime that this object was created by Merge.
modified_atDateTime (ISO 8601)
The datetime that this object was modified by Merge.
nameString
The file's name.
file_urlString
The URL to access the file.
file_thumbnail_urlString
The URL that produces a thumbnail preview of the file. Typically an image.
sizeInteger
The file's size, in bytes.
mime_typeString
The file's mime type.
descriptionString
The file's description.
folderUUID
The folder that the file belongs to.
checksumObject
This field stores file checksum data. 'type' indicates the algorithm (e.g. crc_32, sha1, sha256, quickXor, or md5), and 'content_hash' is the unique hash used to verify file integrity and detect alterations.
permissionsPermission[]
The Permission object
The Permission object is used to represent a user's or group's access to a File or Folder. Permissions are unexpanded by default.
Properties
idUUID
remote_idString
The third-party API ID of the matching object.
created_atDateTime (ISO 8601)
The datetime that this object was created by Merge.
modified_atDateTime (ISO 8601)
The datetime that this object was modified by Merge.
userUUID
The user that is granted this permission. This will only be populated if the type is USER.
groupUUID
The group that is granted this permission. This will only be populated if the type is GROUP.
typeEnum
Denotes what type of people have access to the file. Possible values include: USER, GROUP, COMPANY, ANYONE. In cases where there is no clear mapping, the original value passed through will be returned. To receive all enum values in the original format, use the show_enum_origins query parameter. Learn more.
rolesArray
The permissions that the user or group has for the File or Folder. It is possible for a user or group to have multiple roles, such as viewing & uploading. Possible values include: READ, WRITE, OWNER. In cases where there is no clear mapping, the original value passed through will be returned.
driveUUID
The drive that the file belongs to.
remote_created_atDateTime (ISO 8601)
When the third party's file was created.
remote_updated_atDateTime (ISO 8601)
When the third party's file was updated.
remote_was_deletedBoolean
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.
field_mappingsObject
remote_dataRemoteData[]
The RemoteData object
The RemoteData object is used to represent the full data pulled from the third-party API for an object.
Properties
pathString
The third-party API path that is being called.
dataAny
The data returned from the third-party for this object in its original, unnormalized format.