WOLFRAM

Wolfram Language & System Documentation Center

ExternalStorageDownload[location]

downloads content from the specified location.

ExternalStorageDownload[location,dest]

downloads content from the specified location to a local destination file or directory dest.

ExternalStorageDownload[locationdest]

downloads content from the specified locations to a local destination file or directory dest.

ExternalStorageDownload[{location1,location2,…},dest]

downloads content from the specified locations to local destination dest.

ExternalStorageDownload[{location1,location2,…}dest]

downloads content from the specified locations to local destination dest.

ExternalStorageDownload[{location1dest1,location2dest2,…}]

downloads content from the specified locations to local destinations.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Single File  
Multiple Files  
Options  
ExternalStorageBase  
Amazon S3  
Dropbox  
IPFS  
Properties & Relations  
See Also
Related Guides
Related Links
History
Cite this Page

ExternalStorageDownload

ExternalStorageDownload[location]

downloads content from the specified location.

ExternalStorageDownload[location,dest]

downloads content from the specified location to a local destination file or directory dest.

ExternalStorageDownload[locationdest]

downloads content from the specified locations to a local destination file or directory dest.

ExternalStorageDownload[{location1,location2,…},dest]

downloads content from the specified locations to local destination dest.

ExternalStorageDownload[{location1,location2,…}dest]

downloads content from the specified locations to local destination dest.

ExternalStorageDownload[{location1dest1,location2dest2,…}]

downloads content from the specified locations to local destinations.

Details and Options

  • The default external storage is given by $ExternalStorageBase.
  • Possible forms for location include:
  • "CID"IPFS content identifier (CID)
    "path"path in the external storage service (e.g. Dropbox)
    "bucket/key"bucket name and key in the external storage service (e.g. Amazon S3)
    "bucket/prefix/"bucket name and prefix in the external storage service (e.g. Amazon S3)
    "uri"external storage service URI (e.g. Amazon S3 URI)
    ExternalStorageObject[…]external storage object
  • Possible forms for dest include:
  • "file"local file path
    "directory"local directory
    {"file1","file2",…}list of local file paths

Examples

open all close all

Basic Examples  (4)

Download a file from the InterPlanetary File System (IPFS):

Wolfram Language code: file = ExternalStorageDownload[ExternalStorageObject["QmXpif6oKinoP8CwPMCJPqoJNwvEfzbH1cJg6yZkBLJwKu", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "c9ccd63d95043f5d639a76b932dba6c9"]]]

Import the downloaded content:

Wolfram Language code: Import[file]

Download a file from Dropbox:

Wolfram Language code: file = ExternalStorageDownload["spikey.png", ExternalStorageBase -> "Dropbox"]

Import the downloaded content:

Wolfram Language code: Import[file]

Download a file from an Amazon S3 bucket:

Wolfram Language code: file = ExternalStorageDownload["wolfram-bucket/coneflower.jpg", ExternalStorageBase -> "AmazonS3"]

Import the downloaded content:

Wolfram Language code: Import[file]

Download multiple files from an Amazon S3 bucket by providing an ExternalStorageObject:

Wolfram Language code: files = ExternalStorageDownload[ExternalStorageObject[{"wolfram-bucket/coneflower.jpg", "wolfram-bucket/spikey2.png", "wolfram-bucket/turtle.jpg"}, Association["BucketName" -> "wolfram-bucket", "Path" -> {"coneflower.jpg", "spikey2.png", "turtle.jpg"}, "ExternalStorageBase" -> "AmazonS3"]], ExternalStorageBase -> "AmazonS3"]

Import the downloaded files:

Wolfram Language code: Import /@ files

Scope  (11)

Single File  (7)

Download a file from the InterPlanetary File System (IPFS) by providing its content identifier (CID):

Wolfram Language code: ExternalStorageDownload["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf"]
Wolfram Language code: Import[%]

Download a file from the InterPlanetary File System (IPFS) by providing an ExternalStorageObject:

Wolfram Language code: ExternalStorageDownload[ExternalStorageObject["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "38cb6f3cd68c6c723591a8a385732560"]]]

Upload a file to Dropbox:

Wolfram Language code: eso = ExternalStorageUpload["ExampleData/spikey2.png", "NonExistentFolderX77/spikey.png", ExternalStorageBase -> "Dropbox"]
Wolfram Language code: eso["Path"]

Download a file from Dropbox by providing its location path:

Wolfram Language code: ExternalStorageDownload[eso["Path"], ExternalStorageBase -> "Dropbox"]
Wolfram Language code: Import[%]

Download a file from the InterPlanetary File System (IPFS) to a specific local path:

Wolfram Language code: ExternalStorageDownload[ExternalStorageObject["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "38cb6f3cd68c6c723591a8a385732560"]], "~/Downloads/Wolfram/Spikey.png"]
Wolfram Language code: Import[%]

Download a file from an Amazon S3 bucket:

Wolfram Language code: ExternalStorageDownload["wolfram-bucket/coneflower.jpg", ExternalStorageBase -> "AmazonS3"]
Wolfram Language code: Import[%]

Download a file from an Amazon S3 bucket by providing an ExternalStorageObject:

Wolfram Language code: ExternalStorageDownload[ExternalStorageObject["Choriza.jpg", Association["BucketName" -> "wolfram-bucket", "ExternalStorageBase" -> "AmazonS3", "Path" -> "Choriza.jpg"]]]
Wolfram Language code: Import[%]

Download a file from an Amazon S3 bucket to a specific local destination:

Wolfram Language code: ExternalStorageDownload[ExternalStorageObject["zip.jpeg", Association["BucketName" -> "wolfram-bucket", "ExternalStorageBase" -> "AmazonS3", "Path" -> "zip.jpeg"]], FileNameJoin[{$HomeDirectory, "zipDoggy.jpeg"}]]
Wolfram Language code: Import[%]

Using the syntax locationdest produces the same result:

Wolfram Language code: ExternalStorageDownload[ExternalStorageObject["zip.jpeg", Association["BucketName" -> "wolfram-bucket", "ExternalStorageBase" -> "AmazonS3", "Path" -> "zip.jpeg"]] -> FileNameJoin[{$HomeDirectory, "zipDoggy.jpeg"}]]

Multiple Files  (4)

Download multiple files from an Amazon S3 bucket:

Wolfram Language code: locations = Table[StringRiffle[{"wolfram-bucket", "jpgFiles", "image" <> ToString[i] <> ".jpg"}, "/"], {i, 1, 3}]
Wolfram Language code: files = ExternalStorageDownload[locations, ExternalStorageBase -> "AmazonS3"]
Wolfram Language code: Import /@ files

Download multiple files from an Amazon S3 bucket by providing an ExternalStorageObject:

Wolfram Language code: files = ExternalStorageDownload[ExternalStorageObject[{"Cali.jpg", "Choriza2.jpg", "Choriza.jpg", "ThaiCali.jpg", "zip.jpeg"}, Association["BucketName" -> "wolfram-bucket", "ExternalStorageBase" -> "AmazonS3", "Path" -> {"Cali.jpg", "Choriza2.jpg", "Choriza.jpg", "ThaiCali.jpg", "zip.jpeg"}]]]
Wolfram Language code: Import /@ files

Download multiple files from an Amazon S3 bucket to a specific local directory:

Wolfram Language code: files = ExternalStorageDownload[ExternalStorageObject[{"wolfram-bucket/coneflower.jpg", "wolfram-bucket/spikey2.png", "wolfram-bucket/turtle.jpg"}, Association["BucketName" -> "wolfram-bucket", "Path" -> {"coneflower.jpg", "spikey2.png", "turtle.jpg"}, "ExternalStorageBase" -> "AmazonS3"]], $HomeDirectory]
Wolfram Language code: Import /@ files

Download multiple files from an Amazon S3 bucket to specific local destinations:

Wolfram Language code: destinations = Table[FileNameJoin[{$HomeDirectory, "image" <> ToString[i] <> ".jpg"}], {i, 1, 3}];
Wolfram Language code: ExternalStorageDownload[ExternalStorageObject[{"jpgFiles/image1.jpg", "jpgFiles/image2.jpg", "jpgFiles/image3.jpg"}, Association["BucketName" -> "wolfram-bucket", "ExternalStorageBase" -> "AmazonS3", "Path" -> {"jpgFiles/image1.jpg", "jpgFiles/image2.jpg", "jpgFiles/image3.jpg"}]], destinations, ExternalStorageBase -> "AmazonS3"]
Wolfram Language code: Import /@ %

The first argument can also be a list of locations:

Wolfram Language code: locations = Table[StringRiffle[{"wolfram-bucket", "jpgFiles", "image" <> ToString[i] <> ".jpg"}, "/"], {i, 1, 3}]
Wolfram Language code: ExternalStorageDownload[locations, destinations, ExternalStorageBase -> "AmazonS3"]

Using the syntax locationdest produces the same result:

Wolfram Language code: ExternalStorageDownload[locations -> destinations, ExternalStorageBase -> "AmazonS3"]

A list of rules {location1dest1,location2dest2,…} is also equivalent:

Wolfram Language code: ExternalStorageDownload[MapThread[Rule, {locations, destinations}], ExternalStorageBase -> "AmazonS3"]

Options  (4)

ExternalStorageBase  (4)

Amazon S3  (2)

Download a file from an Amazon S3 bucket:

Wolfram Language code: ExternalStorageDownload["wolfram-bucket/coneflower.jpg", ExternalStorageBase -> "AmazonS3"]

Download multiple files from an Amazon S3 bucket:

Wolfram Language code: locations = Table[StringRiffle[{"wolfram-bucket", "jpgFiles", "image" <> ToString[i] <> ".jpg"}, "/"], {i, 1, 3}];
Wolfram Language code: ExternalStorageDownload[locations, ExternalStorageBase -> "AmazonS3"]

Dropbox  (1)

Upload a file to Dropbox:

Wolfram Language code: eso = ExternalStorageUpload["ExampleData/spikey2.png", ExternalStorageBase -> "Dropbox"]
Wolfram Language code: eso["Path"]

Download a file from Dropbox:

Wolfram Language code: ExternalStorageDownload["spikey2.png", ExternalStorageBase -> "Dropbox"]
Wolfram Language code: Import[%]

IPFS  (1)

Download a file from the InterPlanetary File System (IPFS):

Wolfram Language code: ExternalStorageDownload["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf", ExternalStorageBase -> "IPFS"]
Wolfram Language code: Import[%]

Properties & Relations  (1)

CopyFile also supports an ExternalStorageObject as a file specification to download it to a local path:

Wolfram Language code: CopyFile[ExternalStorageObject["Qmd1HkTU55zaCDnX2wbnVoq15aPHdutn8c3epuJFAt4dgf", Association["ExternalStorageBase" -> "IPFS", "FileHash" -> "38cb6f3cd68c6c723591a8a385732560"]], "~/Downloads/Wolfram/Spikey.png"]
Wolfram Language code: Import[%]
Wolfram Research (2020), ExternalStorageDownload, Wolfram Language function, https://reference.wolfram.com/language/ref/ExternalStorageDownload.html (updated 2021).

Text

Wolfram Research (2020), ExternalStorageDownload, Wolfram Language function, https://reference.wolfram.com/language/ref/ExternalStorageDownload.html (updated 2021).

CMS

Wolfram Language. 2020. "ExternalStorageDownload." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2021. https://reference.wolfram.com/language/ref/ExternalStorageDownload.html.

APA

Wolfram Language. (2020). ExternalStorageDownload. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ExternalStorageDownload.html

BibTeX

@misc{reference.wolfram_2026_externalstoragedownload, author="Wolfram Research", title="{ExternalStorageDownload}", year="2021", howpublished="\url{https://reference.wolfram.com/language/ref/ExternalStorageDownload.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_externalstoragedownload, organization={Wolfram Research}, title={ExternalStorageDownload}, year={2021}, url={https://reference.wolfram.com/language/ref/ExternalStorageDownload.html}, note=[Accessed: 12-June-2026]}