import File from '../_parts/_file.md'; import CustomUploadFolder from '../_parts/_custom-upload-folder.md'; import Screenshots from '@site/src/components/Screenshots';

The file field creates a simple file upload with default UI like <input type="file">. Unlike other media fields, this field doesn't use Media Library UI to upload files.

<Screenshots name="file" col1={[ ['https://imgur.elightup.com/LIWgUZW.png', 'The file field interface'], ]} />

Besides the common settings, this field has the following specific settings, the keys are for use with code:

This is a sample field settings array when creating this field with code:

[
    'id'               => 'file',
    'name'             => 'File',
    'type'             => 'file',
    'force_delete'     => false,
    'max_file_uploads' => 2,
],

This field saves multiple attachment IDs in the database. Each value (attachment ID) is stored in a single row in the database with the same meta key (similar to what add_post_meta does with the last parameter false).

This field has some filters to change the texts displayed on the screen..

All filters above accept 2 parameters:

• $string: the string needs to be changed
• $field: array of the field settings

The code below changes the "+ Add new file" string:

add_filter( 'rwmb_file_add_string', function () {
    return '+ New File';
} );