Managing Sessions

When you exit Qt Creator, a snapshot of your current workspace is stored as a session. To restore the session automatically when you start Qt Creator, select File > Session Manager > Restore last session on startup.

When you open or create any of the following items, they automatically become a part of the session:

  • Projects with their dependencies (including SUBDIRS projects)
  • Editors
  • Breakpoints and expressions
  • Bookmarks

A session is personal, that is, not meant to be shared. It is not supposed to reflect the project structure. It contains personal data, such as bookmarks and breakpoints that are usually not of interest to other developers working on the same projects.

For example, if you work on a project and need to switch to another project for a while, you can save your workspace as a session and then close the project and all the files in it. Everything that you open after saving the session becomes a part of a new session. When you want to return to working on the first project, open the saved session. Qt Creator opens the projects and files that belong to the session.

To create a new session or remove existing sessions, select File > Session Manager.

To switch between sessions, choose File > Session Manager. If you do not create or select a session, Qt Creator always uses the default session, which was created the last time you exited Qt Creator.

When you launch Qt Creator, a list of existing sessions is displayed in the Welcome mode.

When you start Qt Creator from the command line, you can give the name of a session as argument and Qt Creator will start with this session.

For more information, see Using Command Line Options.

© 2015 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.