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
    • Barcode
    • Barcode Formats
    • Clean Document
    • Clipping Mask Make and Release
    • Color Mode
    • Comment
    • Compound Path - Make and Release
    • Distribute
    • Duplicate
    • Expand
    • Fit To Bounds
    • Graphic Style
    • Group & Ungroup
    • Layer Methods
    • Outline
    • Pathfinder
    • Place
    • Rasterize
    • Reduce To Basic Appearance
    • Remove
    • Swatch Methods
    • Tags Methods
    • Template
    • Text
    • Transform Methods
    • zOrder
    • Skip and *
  • Colors

    • Color Libraries
  • User Interface

    • Darty User-Interface
    • Tools Tab
    • Tools Builder
      • Builder Table Anatomy
      • Builder Data Sources and Files
      • Builder Method Blocks
      • Builder Rows, Cells, and Navigation
    • Tools Methods
      • Tools Method Actions and Apply Modes
      • Tools Method Table Preview
      • Align Tool
      • Appearance Tool
      • Graphic Style Tool
      • Artboard Tool
      • Attributes Tool
      • Arrange Tool
      • Barcode Tool
      • Color Mode Tool
      • Clean Tool
      • Clipping Tool
      • Comment Tool
      • Compound Path Tool
      • Distribute Tool
      • Duplicate Tool
      • Expand Tool
      • Fit to Bounds Tool
      • Group Tool
      • Ungroup Tool
      • Layer Tool
      • Outline Tool
      • Pathfinder Tool
      • Place Tool
      • Rasterize Tool
      • Reduce Tool
      • Remove Tool
      • Swatches Tool
      • Tags Tool
      • Text Tool
      • Transform Tool
      • Z-Order Tool
    • 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
  • Site Blog

    • ⭐️Getting Started ⭐️
    • ⭐️Placing Images in Darty-Ai ⭐️
    • 🚀 New Features — Darty-Ai 1.7.8 (March 2026)
    • Creating a Basic Pie-Chart with Line-Art & Data
    • Customer Data and Darty-Ai
    • Darty-Ai Now Supports Google Sheets
    • External SVGs with Darty-Ai
    • Preview Your Documents
    • Self-Adjusting Logo Automation
    • State Management for Artwork Appearance
    • Text Replacements and Formatting
    • Using Private Google Sheets Shared with Business Emails
  • Site Pages

    • 🏠 Home
    • 💰 Pricing
    • Downloads
  • Release Notes
  • Downloads

Compound Path - Make and Release

The makeCompoundPath method is used for making compound paths from tagged artworks.
The releaseCompoundPath method is used for releasing tagged compound paths.

The current Tools editor uses the combined compoundPath method and writes mode:make or mode:release. Make can assign tags to the combined result. Release can assign numbered tags with seriesTag and seriesStart.

To prevent the methods being applied to a row, inside the method, leave the tagSearch value blank or set it to "" or use either the generic * property and set the cell value to false or the generic skip property and set the cell value to true.

See the Compound Path Tool for the visual Make and Release editors.

Compound Path Properties

ModeDescription
* 
Set to false if you want the method to be skipped in a particular row.
Valid Values: true or false
mode 
The operation used by the combined compoundPath method.
Valid Values: make, release
seriesStart 
The first number appended to seriesTag when released paths receive numbered tags.
Sample Values: 1, 5, 11
seriesTag 
A tag prefix applied with increasing numbers to paths produced by Release.
Sample Values: part, logoPath
skip 
Set to true is you want the method to be skipped in a particular row.
See * and Skip for details.
Valid Values: true or false
tagSearch 
The tag search of the tagged artwork to make a compound path from, or the compound path to release.
Sample Values: eyes | nose | mouth | ears, face
tags 
A list of Darty tags applied to the compound path produced by Make.
Sample Values: compound, output, logoCompound

Example Spreadsheet and Screenshots

Original Document State

Original Document State


Row - 1

Row - 1: Compound Path created from multiple tagged shapes.

Row - 2

Row - 2: makeCompoundPath is set to FALSE, ignoring the operation; while the compound path tagged as "face" is released.

Row - 3

Row - 3: the skip parameter for
makeCompoundPath is set to TRUE, ignoring the operation; while the compound path tagged as "face" is released.

Row - 4

Row - 4: with both makeCompoundPath and releaseCompoundPath parameters empty, the makeCompoundPath creates the compound path while releaseCompoundPath is ignored.

eyes | nose | mouth | earscomment
makeCompoundPathreleaseCompoundPath
*skiptagSearch: face*
faceBoth the makeCompoundPath and releaseCompoundPath methods will be applied
falsefaceThe makeCompoundPath method will be skipped
truefaceThe makeCompoundPath method will be skipped
""The releaseCompoundPath method will be skipped
Download: compound-path.csv
Download: compound-path.ai
Download: compound-path.zip
Last Updated: 7/21/26, 8:46 AM
Contributors: Trevor, Vasily Hall
Prev
Comment
Next
Distribute