Managing Windows in MPLAB® X IDE

Last modified by Microchip on 2023/11/09 09:12

Controlling Windows to Improve Your Development Experience

The MPLAB® X Integrated Development Environment (IDE) provides numerous ways for you to arrange its windows the way you like.  It supports many window configurations as well as using multiple monitors.  Here we will attempt to explain most of the ways the  MPLAB X IDE offers to control those windows.

Back to top

Window Groups

To simplify the interface appearance, MPLAB X IDE displays each window as a tab inside of a window group.  By default, MPLAB X IDE provides four window groups, Project Group, Editor Group, Navigation Group, and Output Group.

showing mplab x windows groups

Back to top

Dock and Undock Windows

Undock A Window

Right-click on the tab and select Float.

float a window​​​

Back to top

Dock A Window

Right-click on the tab and select Dock and it should re-dock in its original location within the main IDE window.

dock a window​​​

Back to top

Floating a Single Window (Undocking) and Multiple Monitors

To move a window to a location outside the IDE, such as a second monitor, you will first need to float the window. To float a window left-click on the Window tab and drag it away from the IDE. When the window separates from the IDE release the tab. Please note that the window must be removed entirely from the IDE before it is released. 

floating a single window

Back to top

Floating an Entire Window Group

To move a window to a location outside the IDE, such as a second monitor, you will first need to float the window. To float a window left-click on the Window tab and drag it away from the IDE. When the window separates from the IDE release the tab. Please note that the window must be removed entirely from the IDE before it is released. 

floating a windows group

Back to top

View Two Files Simultaneously

Split the Editor Window Between Two Files

Click on a tab in the editor and drag it away from the top of the editor window. You should see a red outline appear in the window that moves depending on where you move the mouse while dragging the tab.

The red outline indicates where the tab will snap into place when you release the mouse button.

  • To split the window horizontally, drag the tab to the left or right side of the editor window until the red outline appears as a box along the side, then release the mouse button.
  • To split the window vertically, drag the tab to the bottom of the editor window until the red outline appears as a box along the bottom (as shown in the image below), then release the mouse button.

splitting the editor window​​

Back to top

Resize the Split Window

To resize the proportions of a split window move the mouse to the line that divides the two panes. The cursor should become a double ended arrow. Click and drag to change the portion of the window allotted to each pane.

resize a split window​​

Back to top

Resizing a Window or Window Group

Window groups can be resized within the IDE by clicking on an edge of the window or group and manually resizing it.  When the edge of a window group is selected, the cursor will display as a double arrow, similar to what personal computer operating systems display when resizing windows.

To maximize the editor window so that it fills the entire application window, click on the maximize button at the top right of the editor with a small window icon in it.

resize a windows group

Back to top

Splitting Windows

Right-click on a tab in the Editor window and select Clone.

Select clone from menu​​


Left-click on the new tab and drag it away from the top. Move it around until the red outline snaps into the location you wish to place the new window pane. Then, release the mouse.

move to snap new window into place​​


Left-click in the space between the window panes (the mouse pointer should have an arrow on both ends) and drag to resize the window panes to suit your needs.

drag to resize​​

Back to top

Restore a Single Editor Window

Restoring a Split Window

The procedure to merge a split window back into a single window is similar to the procedure used to split it in the first place.

Click on a tab in the editor and drag it away from the top of the editor window. You should see a red outline appear in the window that moves depending on where you move the mouse while dragging the tab.

The red outline indicates where the tab will snap into place when you release the mouse button. Drag the tab to the top of the window until the red outline appears as a box along the top with the tab's outline in the tab bar, then release the mouse and the tab should pop into place in the same position within the row of tabs as its outline indicated. If you don't see the tab's outline as part of the box at the top of the window and you release the mouse, you will simply split the window vertically.

restoring a single editor window

Back to top

Maximize the Editor Window

Maximizing the Editor

To maximize the editor window so that it fills the entire application window, click on the maximize button at the top right of the editor max iconwith a small window icon in it.

max the window

Back to top

Working Around the Maximized Editor

While maximized, all other windows are minimized to the left sidebar or bottom bar.

Maximized Editor window

If you click on a window's icon in the left side or bottom bar, it will open temporarily allowing you to work with its contents. Clicking outside of the window will cause it to minimize back to the bar.

max menu

Back to top

Restore the Editor Window

To restore the editor window back to its original size, click on the minimize button minimize icon​​ at the top right of the editor in it.

restore editor to normal position

Back to top

Creating Additional Window Groups

Left-click on the tab of a window that you want in the new group. Move the window to a position in the IDE such that an orange box appears around the window. When the outline appears, release the tab. A new group will be created.  

creating a new windows group

Back to top

Minimizing Window Groups

To make room in the IDE for editing, the Project, Navigator, and Output groups can all be minimized by using the Minimize Window Group icon. When these groups are minimized, they appear on the margins of the IDE. Minimized groups are restored by using the Restore Window Group icon. 

The Editor Window Group will expand to fill the unused IDE space as other window groups are minimized. 

minimizing a group

Back to top

Moving a Window to Another Group

Left-click on a widow tab and drag it to another group. Hold the window near the tab at the top of the destination group. Release the tab when the orange outline of a tab appears in the destination group.

move window to a new group

Back to top

Resetting Window Locations

From the Menu bar, select Window > Reset Window.

The IDE will restore the windows to the default installation location and size.

MPLAB X IDE retains the default location of its windows in a file. On rare occasions, this file may become corrupt. A corrupt file will present itself by placing the IDE window in odd and unusable locations. If Window > Reset Windows does not restore the window to an appropriate place you will need to restore MPLAB X IDE to its original state manually.

resetting the windows

Back to top