Import files
Last updated on
11 June 2026
File sources may use any of the following protocols:
https://— a remote file URLpublic://— the site's public files directoryprivate://— the site's private files directory
Importing a single file
Map a file field to a column whose cells contain a single file source. The
importer copies the file into the site's file system and stores its file ID on the
field.
title,field_image
"Article one",public://images/one.jpg
"Article two",https://example.com/two.pngImporting multiple files
Use the values() or multiple() syntax to attach several
files to a multi-value field in a single cell. Separate paths with a
+ sign.
title,field_gallery
"Gallery node",values(public://image-1.jpg+public://image-2.jpg+public://image-3.jpg)Each path is attached independently; the field receives a list of file references.
Any individual path that is not an allowed, readable source is skipped.
Help improve this page
Page status: No known problems
You can:
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion