IntelliJ IDEA 2020.1 Help

sbt tool window

The sbt tool window is enabled automatically when you create or open your sbt project. Click sbt on the right sidebar to open the tool window. The tool window displays the sbt linked projects, their tasks, dependencies, and all changes made to the underlying build.sbt file.

sbt

Item

Description

Show option menu

Click this button to open the menu for configuring the current view and changing the tool window viewing modes. The menu items are options that you can turn on or off. An active item contains a check mark on the left side of its name.

The available options in the menu are as follows:

  • Group Modules: select this option if you want to group modules in the project.

  • Group Tasks: select this option if you want to group your tasks. For example, build tasks will be included into the build directory.

  • Show Ignored: select this option to display the ignored projects.

  • Show Toolbar: select this option to show the toolbar for your sbt projects.

  • View Mode Pinned Mode, Docked Mode, Floating Mode, Split Mode - these options let you control general appearance and behavior of the tool window, see Tool Windows Viewing Modes

  • Group Tabs: deselect this option to see the views on separate tabs if more than one view is available in a tool window.

  • Move to: select this option to move the sbt tool window to either top, left or right.

  • Resize: select this option to resize the sbt tool window.

Hide tool window

Use this icon or shortcut to hide the tool window Shift+Escape.

When used in combination with the Alt key, clicking this icon hides all the tool windows attached to the same tool window bar.

Toolbar

Item

Description

icons actions refresh

Click this button to refresh all registered sbt projects after changes have been made to an sbt script.

icons general add

Click this button to link an sbt project.

icons general remove

Click this button to detach an external sbt project.

icons actions expandall icons actions collapseall

Use these buttons to expand or collapse all the nodes.

Select Project Data to Import

Click this button to import a module or a data to your sbt project. It might be useful for the multi-module projects.

Auto-reload external changesThis icon is enabled by default. In this case, changes that you made to your build files outside the IDE or VCS changes are automatically reloaded. To reload changes made to the current build.sbt file, press the Load sbt Changes icon in the editor.

If you want to manually control when to reload the changes, disable Auto-reload external changes. For example, if you switch between branches and don't want IntelliJ IDEA to automatically start the reloading process it might be helpful to disable this option.

the sbt settings

Click this button to configure the settings of the current sbt project.

Context Menu

Item

Description

Open sbt config

Select this option to open sbt.build file in the editor.

Refresh external project

Select this option to refresh all external projects.

Ignore sbt project

If you select this option, IntelliJ IDEA starts to ignore the selected module on the next project's import. In this case, IntelliJ IDEA keeps the ignored sbt projects and subprojects in the sbt tool window, but stops their import (modules, content roots, tasks, and so on) to the project. However, IntelliJ IDEA synchronizes the ignored projects with the current one.

Task Activation

Select this option to activate tasks to run.

Last modified: 25 May 2020