joins the namei together into a file name suitable for your current operating system.


joins the namei to the path in the specified cloud object.


joins the namei to the path in the specified local object.

Details and Options

  • The "namei" can be either individual names or file paths containing pathname separators.
  • FileNameJoin[{"","name1",}] gives an absolute file path beginning with a pathname separator.
  • FileNameJoin[,OperatingSystem->"os"] yields a file name in the format for the specified operating system. Possible choices are "Windows", "MacOSX", and "Unix".
  • FileNameJoin just assembles a file name; it does not actually search for the file specified.
  • FileNameJoin["name"] canonicalizes the file name "name", making pathname separators appropriate for your operating system. FileNameJoin also works with file-based URLs.


open allclose all

Basic Examples  (4)

Give a system-dependent file name:

Append the file name to a path:

On Windows, the share name is treated as a single unit:

Construct a cloud object from a directory cloud object and a file name:

Scope  (2)

Append file name to a cloud object:

Append paths to a local object:

Possible Issues  (1)

Deploying to a cloud path generated with FileNameJoin will fail if the parent object is not a directory:

Introduced in 2008
Updated in 2019