Search Path

View and change MATLAB® search path

The MATLAB search path is a subset of all the folders in the file system. MATLAB uses the search path to efficiently locate files used with MathWorks® products. For more information, see What Is the MATLAB Search Path?

Functions

addpathAdd folders to search path
rmpathRemove folders from search path
pathView or change search path
savepathSave current search path
userpathView or change default user work folder
genpathGenerate path name
pathsepSearch path separator for current platform
pathtoolOpen Set Path dialog box to view and change search path
restoredefaultpathRestore search path to factory-installed state
rehashRefresh function and file system path caches

Topics

What Is the MATLAB Search Path?

The search path, or path is a subset of all the folders in the file system that MATLAB uses to locate files efficiently.

Change Folders on the Search Path

Interactively add and remove folders, and change the order of folders on the search path, for the current MATLAB session and for future MATLAB sessions.

Use Search Path with Different MATLAB Installations

The default search path changes for each MATLAB version because the default folders that come with the products change.

Add Folders to the MATLAB Search Path at Startup

The startup.m file is for specifying startup options. Add folders to the search path by including addpath statements in startup.m.

Assign userpath as Startup Folder (Macintosh or UNIX)

Assign the userpath folder as the startup folder on Macintosh or UNIX® platforms.

Files and Folders that MATLAB Accesses

When you do not specify a path to a file, MATLAB looks for the file in the current folder or on the search path. Functions in the current folder take precedence over functions with the same file name that reside anywhere on the search path.

Toolbox Path Caching in MATLAB

For performance reasons, MATLAB caches matlabroot folder information across sessions.

Troubleshooting

Path Unsuccessfully Set at Startup

When there is a problem with the search path, you cannot use MATLAB successfully. There are several recovery steps available to correct problems with the search path.

Errors When Updating Folders on Search Path

You can encounter errors or unexpected behavior when you try to delete, rename, or move folders.

Troubleshoot Invalid or Unresponsive Windows Change Notification Handles

If MATLAB is unable to detect changes to your files and folder due to invalid or unresponsive change notification handles, you can change how MATLAB detects changes in folders.