Opening a Project in Altium Designer

This document is no longer available beyond version 22. Information can now be found here: Opening a Project using the Open Project Dialog for version 24

Parent page: Working with Projects

To work on a managed project, you effectively check it out as a local working copy. This is performed directly from within Altium Designer using the File » Open Project command. What happens next depends on whether you are a member of the Workspace team or have been shared a project outside of the Workspace team.

  • Workspace Team Member – the Open Project dialog will open in which you can choose which managed project to open from your connected Workspace (when connected to a Workspace, that Workspace will appear in the Locations region of the dialog, distinguished by the icon, and appear with the name given to the Workspace). Only those managed projects that have been shared with you (you have permission to access them) will be listed.
  • Once opened, the project will appear under an entry for the Workspace, in the Projects panel.
  • Choose which managed project to open from your connected Workspace within Altium Designer from those currently shared with you.
  • You have the option to open the project to the default checkout path or use the drop-down menu to specify a custom path. The default checkout path is defined as a property of the design repository in which the project resides. For a Git repository (e.g. the Versioned Storage repository that is native to the Workspace), this is the Local Path field found in the Git Repository dialog. For an SVN repository, this is the Default Checkout Path field found in the SVN Design Repository dialog. Access the properties dialog by selecting the entry for the repository on the Data Management – Design Repositories page of the Preferences dialog then clicking the button.
  • Choose the Open Project As Copy option to create a cloned version of the project under a different name.
  • When browsing the project through Altium Designer's Explorer panel, click the button at the top-right of the panel, to open the project in Altium Designer (adding it to the Projects panel).
  • Invited Stakeholder Outside of the Workspace Team – the Open Project dialog will open in which you can access any managed project that has been shared with you from the Shared With Me location.
  • Once opened, the project will appear under the entry Shared with me, in the Projects panel. What you can do with the project depends on the access rights you have been given to it. If editing rights were assigned to you, you will be able to edit the design normally, which would typically be the case for an external contractor. If you have viewing rights only, you will be able to comment on the WIP design.
  • The projects that are available under Shared With Me are those that have been shared with your sign-in name (your AltiumLive account) from an Altium 365 Workspace. Note that Altium Designer does not need to be connected to a Workspace to access shared projects.
  • Choose which managed project to open, from within Altium Designer, from those currently shared with you as an external stakeholder. Note that access is made to such projects without having access to the Workspace.
You have the option to open the project to the default checkout path or use the drop-down menu to specify a custom path. The default checkout path is taken from the Document Path field on the System – Default Locations page of the Preferences dialog.
  • When an updated project file name has been synchronized to the Workspace, the Workspace automatically changes the Workspace project's Name parameter to match. Conversely, when the name of a Workspace project is updated in the Workspace (via the Edit mode on the Workspace Projects page or the design client's Explorer panel), the change is propagated to the client-side when the project is next opened. When the updated project is opened (File » Open Project), the Name of the project and project file name are different dialog will open, providing the option to align the project file name with the new project Name, force the project Name to match the existing project file name, or allow the two names to be different.
  • Attempting to open a project that is already open will result in no action.
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.