Altium Designer Documentation


Created: August 2, 2022 | Updated: August 2, 2022

Parent page: PCB Query Functions - Membership Checks


Returns all objects that exist on the specified layer.


ExistsOnLayer(Layer : String) : Boolean/Boolean_String

Layer is the name of the layer as it appears on the Layers & Colors tab of the View Configuration panel.

Example Usage

ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'

Returns all objects that exist on the Top Layer.

Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'

Returns all objects except objects that exist on the Mechanical 3 layer.


  1. The single quote characters (') at the start and end of Layer are mandatory.
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: