$UserBaseDirectory

$UserBaseDirectory
gives the base directory in which user-specific files to be loaded by Mathematica are conventionally placed.

DetailsDetails

  • $UserBaseDirectory returns the full name of the directory as a string.
  • Typical values are:
  • C:\Users\username\AppData\Roaming\Mathematica
    Windows
    ~/Library/MathematicaMacintosh
    ~/.MathematicaUnix
  • The value of $UserBaseDirectory can be specified by setting the operating system environment variable when the Mathematica kernel is launched. It cannot be reset from inside the kernel.
  • Typical subdirectories of $UserBaseDirectory are:
  • ApplicationsMathematica application packages
    Autoloadpackages to be autoloaded on startup
    FrontEndfront end initialization files
    Kernelkernel initialization files
    Licensinglicense management files
    SystemFilesgeneral system files
  • These subdirectories are, if possible, created automatically the first time Mathematica is run by a given user.
  • Appropriate subdirectories are automatically included on $Path.
  • The subdirectories of $UserBaseDirectory are given in $Path before the corresponding subdirectories of $BaseDirectory.

ExamplesExamplesopen allclose all

Basic Examples (2)Basic Examples (2)

The base directory in which user-specific files are placed:

In[1]:=
Click for copyable input
Out[1]=

Subdirectories and files of $UserBaseDirectory:

In[1]:=
Click for copyable input
In[2]:=
Click for copyable input
Out[2]=
In[3]:=
Click for copyable input
New in 5
New to Mathematica? Find your learning path »
Have a question? Ask support »