DocumentationDocumentation
Darty.ai
Get Started
Basics
Methods
Colors
UI
Workflows
Darty.ai
Get Started
Basics
Methods
Colors
UI
Workflows
  • Get Started

    • Installation and Login
    • Your First Darty Document
    • Installers - Instructions and Downloads
    • Licensing
  • Basics

    • Darty Basics
    • Darty Header
    • Darty Tags
  • Methods

    • Darty Methods
    • Align
    • Appearance - General
    • Appearance - Colors & Swatches
    • Appearance - Effect Properties
    • Artboard Methods
    • Arrange
    • Attributes
    • Clean Document
    • Clipping Mask Make and Release
    • Color Mode
    • Compound Path - Make and Release
    • Distribute
    • Duplicate
    • Expand
    • Fit To Bounds
    • Group & Ungroup
    • Layer Methods
    • Outline
    • Pathfinder
    • Place
    • Rasterize
    • Reduce To Basic Appearance
    • Remove
    • Swatch Methods
    • Tags Methods
    • Text
    • Transform Methods
    • zOrder
    • Skip and *
  • Colors

    • Color Libraries
  • User Interface

    • Darty User-Interface
    • Tags Tab
    • Data Tab
    • Export Tab
    • Settings Tab
    • Help Tab
    • Export Settings
    • Export Validation
    • Job Export Settings
    • Export Counter Variables
    • Export Progress
    • Export Presets
    • Recent Files
    • Color Dialog
  • Cloud Data

    • Darty-Ai Cloud Data Integrations
    • Darty-Ai with Google Sheets
  • Workflows

    • Darty Workflows
    • Darty Preview
    • Darty Export Workflows
    • Darty Data Workflows

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

PropertyDescription
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
sendlayerNamelayerNumber
forwards
backwards
front
back
forwards3
backwardsLayer 5
front3
back3

Sample Download Links

Download: arrange.xlsx
Download: arrange.ai
Download: arrange.zip
Last Updated: 3/17/26, 2:19 AM
Contributors: Trevor
Prev
Artboard Methods
Next
Attributes