Main Content

Configure Global MATLAB Projects Settings

You can configure the global MATLAB® projects settings to specify project definition files type, detect project files that are shadowed by open models, and detect project-wide references when you rename, remove, and delete files.

To configure project-specific settings such as the project name, path, and labels, see Manage Project Settings, Path, Labels, and Startup and Shutdown Tasks instead.

On the Home tab, in the Environment section, click Settings. Select MATLAB > Project. Then, adjust the settings as this table describes.

SettingUsage
New Projects

By default, MATLAB creates a new project in the currently opened folder in the Files panel.

To specify a different Default folder for creating new projects, select Use specified folder. Then, specify or browse to a folder on your system.

To specify the Project definition files type for new projects, select an option based on your use case:

  • The Use multiple project files (fixed path length) option is preferable if you need to work with long paths (default).

  • The Use multiple project files option avoids file conflicts when you perform merge on shared projects.

  • The Use a single project file (not recommended for source control) option is fast but often causes merge issues when two users submit changes in the same project to a source control tool.

For details, see Project Definition Files.

The Project definition folder path, relative to the project root, contains the project metadata files. Select one of the available options to specify the folder name.

Project Startup

To disable the warning you receive when opening a project from an unknown source for the first time, clear Warn when opening projects from unknown sources.

For details, see Unsafe Content Warning.

To open the project welcome page after you open a project, select Show the welcome dialog after opening a project.

To receive a warning about files that are shadowed by open models when you open a project, select Detect project files shadowed by open models.

For details, see Manage Shadowed and Dirty Model Files and Other Project Files (Simulink).

On project startup, MATLAB recreates missing project folders. Use this default setting if you require empty folders in a project under source control that are intended for training or as procedure templates.

For large projects, to avoid performance issues on startup, disable Recreate missing project folders.

Project Shutdown

To receive a warning about files with unsaved changes when you close a project, select Interrupt project close if there are dirty project files.

To automatically close project models when you close a project unless the project models contain unsaved changes, select Check for open project models and close them, unless they are dirty.

To receive a confirmation request when closing a project, select Ask for confirmation when closing a project.

File Management

When you have a project open, the Project panel shows all files and folder under the project root folder. If you use the Files panel to navigate to a different folder, the Project panel displays a banner that the current project and the current folder are different.

To disable the banner altogether, clear Show banner when current folder is not in the project root.

When you rename, delete, or move files in a project or a project reference, a dependency analysis runs and proposes automatic updates. By default, the analysis runs on project files only. You can choose to run the analysis on all files or disable the automatic updates altogether.

In Detect file uses upon renaming, moving, or deletion in project hierarchy, select one of these options:

  • Only for project files (default)

  • Always

  • Never

For details, see Manage Project Files.

To disable the project prompt and analysis when you rename buses or bus elements while keeping automatic updates enabled for other files, clear Detect impact across project hierarchy when renaming Simulink buses and bus elements.

This option is available only if you have Simulink® installed.

When you add project files to a folder that is not on the path, you can choose whether MATLAB notifies you before adding the folder to the project path. In Update project path when adding files, select one of these options:

  • Ask every time (default)

  • Always

  • Never

To specify the project behavior when you attempt to modify Read-only project files, select an option based on your use case:

  • Always make writable (default)

  • Never make writable

See Also

Topics