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

Pathfinder Tool

Use Tools → Methods → Pathfinder to combine, subtract, divide, crop, or outline tagged Illustrator artwork. The selected operation changes the actual path structure; it is not added as an editable live Pathfinder effect.

Pathfinder is most useful when several overlapping objects need to become a new production-ready shape. Because the operation can replace the source objects, remove hidden regions or strokes, and outline text before combining it, test representative artwork or save a copy before applying a reusable row broadly.

For accepted operation values and illustrated spreadsheet examples, see the Pathfinder method reference.

Pathfinder Editor

Pathfinder method editor

The editor answers three practical questions:

  1. Which artwork should participate?
  2. How should those objects be combined?
  3. Does the returned result need an additional numbered Darty tag?

Choose the Artwork to Combine

Artwork Tags identifies the source artwork and becomes the Darty sheet's target header. Enter a focused tag search such as logo-part, front | back, or another expression that resolves to the complete set of objects required by the operation.

If Artwork Tags is blank, the Table preview normalizes the target to *. That broad target can include far more document artwork than expected, which is particularly risky for a structural operation. Prefer a narrow, verified tag search when saving a Pathfinder row for reuse.

Use Selection Tags copies the existing Darty tags from the current Illustrator selection into Artwork Tags. It does not perform Pathfinder or create tags by itself. When the selected objects do not already share a useful search, use Apply to Selection for a one-time test instead.

Apply to Selection temporarily targets the currently selected Illustrator objects, runs the chosen operation, and does not add a row to the Pathfinder Table. The Artwork Tags value displayed in the editor remains unchanged. See Darty Tags for reusable search syntax.

Stacking order matters. Minus Front, Minus Back, and Crop distinguish frontmost and backmost objects according to Illustrator's paint order, not the order in which tags appear in the search.

Choose the Resulting Geometry

The Operation selector writes mode. Unite is selected by default, so every captured Pathfinder row contains a valid operation even when the user does not change the selector.

Choose the operation by the result the artwork needs:

OperationGenerated valueResult
UniteuniteCombines overlapping paths into one object using the front object's appearance.
Minus FrontminusFrontCuts the front objects and their overlapping areas out of the backmost object.
Minus BackminusBackCuts the back objects and their overlapping areas out of the frontmost object.
IntersectintersectKeeps only the region shared by the source objects.
ExcludeexcludeRemoves shared overlap while keeping non-overlapping regions.
DividedivideSplits the artwork into pieces wherever object boundaries intersect.
TrimtrimRemoves hidden overlaps behind front objects and removes strokes.
MergemergeCombines adjoining areas with matching fills, removes hidden overlaps, and removes strokes.
CropcropUses the frontmost object as the cropping shape and keeps artwork inside it.
OutlineoutlineConverts the objects into unfilled, unstroked path segments along their boundaries.

These modes follow Illustrator Pathfinder concepts, so the same practical concerns apply:

  • Unite, subtraction, intersection, and exclusion are appropriate when the desired output is a consolidated silhouette or cutout.
  • Divide, Trim, Merge, Crop, and Outline can produce a result containing several internal pieces even though Darty receives one returned result object or container.
  • Trim and Merge intentionally remove strokes.
  • Crop depends on the frontmost object's position in the stacking order.
  • Text among the source artwork is converted to outlines before Pathfinder runs, so it will no longer remain editable text afterward.

Pathfinder is designed for compatible vector artwork. A valid tag search is not proof that the matched object types, overlap, and paint order can produce the intended result.

Preserve and Add Darty Tags on the Result

Darty reads the source objects' existing Darty tags before Pathfinder changes their structure and writes the combined set of source tags onto the returned result. This helps later rows continue to find the new geometry using tags that described its inputs.

The optional Result Tags section adds one predictable numbered tag:

  • Series Tag writes seriesTag and supplies the prefix.
  • Series Start writes seriesStart and supplies the number appended to that prefix. Its default is 1 when a Series Tag is used without another starting number.

For example, Series Tag pathResult with Series Start 5 adds the tag pathResult5 to the Pathfinder result.

In this method, Series Tag does not assign a different number to every piece produced inside Divide, Trim, or Outline. The numbered tag is written to the single result object or result container returned by Pathfinder. Use a later structural method when internal pieces must become separately tagged targets.

Series Start has no effect without Series Tag. Leave both fields blank when the preserved source tags are enough for later targeting.

Skip a Reusable Pathfinder Row

Skip is a three-state checkbox that writes skip only when True or False is chosen.

  • True writes skip:true and bypasses Pathfinder for the current data record.
  • False writes skip:false and explicitly allows it to run.
  • Unset omits the property and allows normal execution.

Skip is useful when a larger sheet contains records that must keep their original paths. See Skip and *.

Validation, Errors, and Safe Testing

Add Row can capture a configuration without checking the active document. It confirms how the editor serializes the target, operation, and result tags; it does not prove that the target exists or that Illustrator can combine the matched objects.

When Pathfinder runs, the status can report:

  • Tagged art not found when the target search or temporary selection target resolves to no artwork.
  • Can't combine objects when Illustrator cannot complete the chosen operation on the matched geometry.
  • Invalid mode for a manually authored row whose mode is not one of the supported values. The visual selector itself only offers valid modes.

If Apply to Selection finds no current Illustrator selection, the method does not run and asks for artwork to be selected first.

Before applying to production artwork:

  1. Confirm that every intended source object is included and unrelated artwork is excluded.
  2. Check front-to-back order for subtraction and Crop.
  3. Duplicate the artwork or save the document when the original editable construction may still be needed.
  4. Use Apply to Selection for a one-time trial when the intended source set is already selected.
  5. Inspect fills, strokes, holes, grouping, text editability, and Darty tags after the operation.

Reset restores the editor and clears its working Table preview, but it does not restore geometry already changed in Illustrator.

Build a Useful Pathfinder Configuration

A practical order is:

  1. Decide what final geometry is required: a union, cutout, overlap, split, crop, or outline.
  2. Prepare the source objects' stacking order, especially for Minus Front, Minus Back, and Crop.
  3. Enter a narrow Artwork Tags search, or select representative artwork for Apply to Selection.
  4. Choose the Pathfinder operation and review its stroke, fill, and text consequences.
  5. Add a Series Tag and Series Start only when the returned result needs an additional predictable target.
  6. Use Add Row to capture without changing Illustrator, Apply to capture and run the row, or Apply to Selection for a one-time test.
  7. Inspect both the generated Table row and the resulting Illustrator structure before reusing the configuration.

Control-to-Property Summary

Editor purposeDarty property
Artwork to combineTarget header / tagSearch
Pathfinder geometry operationmode
Prefix for the additional numbered result tagseriesTag
Number appended to Series TagseriesStart
Skip the method for a data rowskip

Capture, Apply, and Review

  • Tools Method Actions and Apply Modes explains Reset, Add Row, Apply, and Apply to Selection.
  • Tools Method Table Preview explains how to inspect, edit, reorder, copy, download, and apply captured Pathfinder rows.
  • Pathfinder method reference documents operation values and illustrated spreadsheet results.
Last Updated: 7/21/26, 9:47 AM
Contributors: Vasily Hall
Prev
Outline Tool
Next
Place Tool