Qt Creator Manual

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.

A session is an arbitrary collection of:

  • Open projects with their dependencies (including SUBDIRS projects)
  • Open 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. This makes it easier to return to working on the first project later.

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 on the Welcome screen.

When you start Qt Creator from the command prompt, 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.