Import files

Last updated on
11 June 2026

File sources may use any of the following protocols:

  • https:// — a remote file URL
  • public:// — the site's public files directory
  • private:// — 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.png

Importing 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: