Altium Designer Documentation


Created: September 18, 2017 | Updated: October 18, 2017
Now reading version 20.0. For the latest, read: MeasureDistance3D for version 22

Parent page: MultiBoardAssembly Commands

The following pre-packaged resource, derived from this base command, is available:

Applied Parameters: None


This command is used to measure distances between 3D bodies in the active Multi-board Assembly document (*.MbaDoc).

For a high-level look at multi-board design within Altium Designer, see Designing Systems with Multiple Boards.


This command can be accessed from the Multi-board Assembly Editor by:

  • Choosing the Tools » Measure Distance command from the main menus.
  • Using the Ctrl+M keyboard shortcut.


After launching the command, you will enter measurement mode. Measurement is performed as follows:

  1. Choose the first 3D object, or specific face of that object. As you move the cursor over a potential 3D object, the color of that object will change color. If you want to select a specific face of the object, hold the Ctrl key as you move the cursor - the face currently under the cursor will be highlighted. With the cursor in place, click to confirm object/face selection.
  2. Choose the second 3D object, or specific face of that object.
  3. The tool visually presents the shortest distance between the two chosen objects (faces).
  4. Continue measuring the distance between other objects/faces, or press Esc to exit measurement mode.


  1. All measurement results during the active measuring session are presented in the Messages panel. You can double-click on an entry to cross probe to that measurement within the workspace.
  2. Once you end the measuring session, all visual measurements will be cleared, along with all measurement entries in the Messages panel.
  3. When passing the cursor over a 3D body (or face thereof), the color will change to that specified for the Highlight Under Cursor system color, in the System Colors section of the View Configuration panel.


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: