Altium Designer Documentation

Working with a Region Keepout Object on a PCB in Altium Designer

Created: March 19, 2019 | Updated: March 19, 2019
Now reading version 19.1. For the latest, read: Region Keepout for version 21
Applies to Altium Designer versions: 19.0 and 19.1

Parent page: PCB Objects

A Region Keepout
A Region Keepout


A region is a primitive design object. As well as the standard region that is used for design tasks, there is a second type of region available, referred to as a region keepout. A region keepout can be placed as a layer-specific keepout object or an all-layer keepout to act, for example, as a placement or routing barrier. The difference between a standard region and a keepout region is that layer-specific keepout-type fills are not included in output generation, such as Gerber or ODB++. A keepout region is identified by having an outline in the Keepout color.


Region Keepouts are available for placement in both PCB and PCB Library editors in the following ways:

  • In the PCB Editor - place a region keepout in the following ways:
    • Click Place » Keepout » Solid Region from the main menus.
    • Click the  button in the graphic objects drop-down on the Active Bar menu located at the top of the workspace. (Click and hold an Active Bar button to access other related commands. Once a command has been used, it will become the top-most item on that section of the Active Bar.)
  • Right-click and choose Place » Keepout » Solid Region from the context menu.
  • In the PCB Library Editor - place a region keepout in the following ways:
    • Click Place » Keepout » Solid Region from the main menus.
    • Click the  button in the graphic objects drop-down on the Active Bar menu located at the top of the workspace. (Click and hold an Active Bar button to access other related commands. Once a command has been used, it will become the top-most item on that section of the Active Bar.)

A region keepout can only be placed on a signal layer or the Keepout layer.


After launching the command, the cursor will change to a cross-hair and you will enter region keepout placement mode. Placement is made by performing the following sequence of actions:

  1. Position the cursor then click to anchor the starting vertex for the region keepout.
  2. Move the cursor ready to place the second vertex. The default behavior is to place two edges with each click, with a user-defined corner shape between them. 
  3. Continue to move the mouse and click to place further vertices.
  4. After placing the final vertex, right-click or press Esc to close and complete placement of the region keepout. There is no need to manually close the region since the software will automatically complete the shape by connecting the start point to the final point placed.
  5. Continue placing further region keepouts or right-click or press Esc to exit placement mode.

Additional actions that can be performed during placement while the region keepout is still floating on the cursor and before the first corner of the region keepout is anchored are:

  • Press the Tab key to pause the placement and access the Keepout - Region mode of the Properties panel from where its properties can be changed on-the-fly. Click the workspace pause button overlay () to resume placement.
  • Press the + and - keys on the numeric keypad to cycle forward and backward through all layers currently visible in the design.
  • Press the * key to cycle through the visible signal layers.​
While attributes can be modified during placement (Tab to access the Properties panel), keep in mind that these will become the default settings for further placement unless the Permanent option on the PCB Editor – Defaults page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.

Graphical Editing

This method of editing allows you to select a placed object directly in the workspace and graphically change its size, shape or location.

A selected Region KeepoutA selected Region Keepout

Move Region Vertices

Region Keepouts contain two points, or "handles", with which to edit the shape of the region.

  1. Full Handles - located at the corners of the region keepout.
  2. Empty Handles - located in the centers of the segments created by the Full Handles.

An existing region keepout can be re-shaped by moving these handles, or vertices, located at each corner or at the center of each edge.

To modify the region keepout shape:

  1. Click and select a region keepout, which will highlight the vertices for the region keepout and change the cursor to a crosshair.
    • Click on a Full Handle to move that corner.
    • Click along an edge to move the entire edge.
    • Click on an Empty Handle to move the whole side (for track and for arc).
    • Ctrl+Click on an Empty Handle to break that edge into two edges. Ctrl only needs to be held at the beginning of movement. The Shift+Spacebar hotkeys can then be used to cycle through modes (arc, miter, and any angle).
  1. If the any angle placement mode creates unwanted vertices, or to remove extra vertices in general, click Ctrl and grab the central full handle. An X icon appears over the handle and dragging the edge will reduce the vertices on that edge to one.

Modify Region Border

In addition to vertex editing, you also can use the Modify Region Border command to easily change the shape of polygons. The command is run by right-clicking on the desired polygon then selecting Polygon Actions » Modify Polygon Border. Once the command is launched, the cursor becomes a crosshair. Each time you click, a new vertex is added. As during region keepout placement, the Shift+Spacebar shortcuts can be used to change corner shapes.

If attempting to graphically modify an object that has its Locked property enabled, a dialog will appear asking for confirmation to proceed with the edit. If the Protect Locked Objects option is enabled on the PCB Editor - General page of the Preferences dialog, and the Locked option for that design object is enabled as well, then that object cannot be selected or graphically edited. Click the locked object to select it then disable the Locked property in the List panel or disable the Protect Locked Objects option to graphically edit the object.

Non-Graphical Editing

The following methods of non-graphical editing are available:

Editing via the Properties Panel

Properties page: Region Keepout Properties

The properties of a Region Keepout can be edited in the PCB editor's Properties panel, which allows editing of all item(s) currently selected in the workspace.

The Keepout - Region mode of the Properties panel  The Keepout - Region mode of the Properties panel  

During placement, the panel can be accessed by pressing the Tab key.

To access the properties of a placed Region Keepout:

  • Double-click on the Region Keepout.
  • Right-click on the Region Keepout then select Properties from the context menu.
  • If the Properties panel is already active, select the Region Keepout.

Editing via the List Panel

Panel pages: PCB List, PCB Filter, PCBLIB List, PCBLIB Filter

The List panel allows you to display design objects from one or more documents in tabular format, enabling quick inspection and modification of object attributes. Used in conjunction with appropriate filtering - by using the applicable Filter panel, or the Find Similar Objects dialog - it enables the display of just those objects falling under the scope of the active filter – allowing you to target and edit multiple design objects with greater accuracy and efficiency.

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: