# Arrange

The arrange method works in the same way as Illustrator arrange method, sending artwork forwards, backwards, to the front and the back of the artwork's layer. It can also be used for layers, sending the layer forwards, backwards, to the front and the back.
For more much more controlled manipulation of the artwork and layer z-order see the zOrder method.

Arrange Panel

Arrange Options

The Original Layers Panel

The Original Layers Panel

The green artwork is moved to the front of it's layer

tagSearch: green
send: front (of layer)

"Layer 2" is sent to the back

layerName: Layer 2
send: back

# Arrange Properties

Property Description
arrange / bring / send 
Where to bring or send the artwork or layer.
Valid Values: forward bringForward, backward sendBackward, front toFront bringToFront, back toBack sendToBack
layerName / name 
The case sensitive name of the layer to be processed. Use either layerName or layerNumber and not both.
Sample Values: Layer 1, Darty Logo
layerNumber / number 
The index of the layer to be processed. Use either layerName or layerNumber and not both.
Sample Values: 1, 4
skip 
skip is a generic property for all methods, when set to true, the method will be skipped. See * and Skip for details.
Valid Values: true or false
tagSearch 
The tag search of the artwork to arrange.
Sample Values: blueDot

# Sample Document Screenshots

Original Document Art

Original Document Art

The Original Layers Panel

The Original Layers Panel

The star shape is moved upwards in the stacking order of its parent layer

tagSearch: star
send: forwards

The star shape is moved downwards in the stacking order of its parent layer

tagSearch: star
send: backwards

The star shape is moved to the top of its parent layer

tagSearch: star
send: front (of Layer)

The star shape is moved to the bottom of its parent layer

tagSearch: star
send: back (of Layer)

The 3rd layer (from the top) is moved upwards in the Document Layer order

layerNumber: 3
send: forwards

The layer named "Layer 5" is moved downwards in the layer order.

layerName: "Layer 5"
send: backards

The 3rd layer (from the top) is moved to the top in the Document Layer order

layerNumber: 3
send: front (of Document's layers or parent Layer)

The 3rd layer (from the top) is moved to the bottom in the Document Layer order

layerNumber: 3
send: back (of Document's layers or parent Layer)

# Sample Arrange Spreadsheet

star
arrange
send layerName layerNumber
forwards
backwards
front
back
forwards 3
backwards Layer 5
front 3
back 3
Download: arrange.xlsx
Download: arrange.ai
Download: arrange.zip
Last Updated: May 30, 2025, 02:32:50