Swatch Type Converter

Swatch Type Converter

Script for Adobe Illustrator

Description

The Swatch Type Converter is a powerful Adobe Illustrator script that allows you to efficiently manage and convert color swatches between different types within your document. This tool provides a user-friendly interface to convert swatches between Global Colors, Spot Colors, and Solid Colors, or delete unwanted swatches entirely.

Features

  • Convert to Global Colors: Transform swatches into global process colors that can be tinted
  • Convert to Spot Colors: Convert swatches to spot colors for special printing inks
  • Convert to Solid Colors: Convert swatches to regular process colors (non-global, non-spot)
  • Delete Swatches: Remove multiple swatches from your document at once
  • Search & Filter: Quickly find swatches by name using the built-in search bar
  • Multi-Select: Select and convert multiple swatches simultaneously
  • Group Preservation: Maintains swatch group organization after conversion
  • Smart Handling: Automatically skips gradient and pattern swatches that cannot be converted
  • Pre-Selection Support: Automatically selects swatches that were selected in the Swatches panel

image galleryimage gallery
Before / After

Installation

1. Download the Swatch Type Converter.jsx script file.

2. Place the script in your Adobe Illustrator Scripts folder:

⮑ Mac: /Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts

⮑ Windows: C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts

3. Restart Adobe Illustrator if it's already running.

Launch the Script

  1. Open your Illustrator document containing the swatches you want to convert.
  2. Run the script via  File > Scripts > Swatch Type Converter.
  3. The Swatch Type Converter dialog window will appear.

image gallery

Using the Script

➊ Select Swatches to Convert

Viewing Your Swatches

  • The dialog displays all document swatches (excluding [None] and [Registration]) in a three-column list: Column 1: Swatch nameColumn 2: Current swatch type (Global Color, Spot Color, Solid Color, Gradient, Pattern, etc.)Column 3: Parent group name (if the swatch belongs to a group)
  • Column 1: Swatch name
  • Column 2: Current swatch type (Global Color, Spot Color, Solid Color, Gradient, Pattern, etc.)
  • Column 3: Parent group name (if the swatch belongs to a group)

Pre-selected Swatches

  • If you have swatches selected in Illustrator's Swatches panel before running the script, they will automatically be selected in the dialog

Selecting Swatches Manually

  • Single selection: Click on a swatch name
  • Multiple selection: Hold Ctrl (Windows) or Cmd (Mac) while clicking multiple swatches
  • Range selection: Click first swatch, then hold Shift and click last swatch

Using the Search Feature

  1. Type in the search box at the top to filter swatches by name
  2. The list updates in real-time as you type
  3. Click the × button to clear the search and show all swatches

➋ Choose Conversion Type

Select one of the following radio button options:


Convert to Global Colors

  • Purpose: Creates process colors that can be tinted while maintaining consistency
  • Best for: Colors you want to use with varying opacity/tints throughout your design
  • Note: Allows you to create lighter/darker versions while keeping the base color linked

Convert to Spot Colors

  • Purpose: Creates special printing inks for precise color reproduction
  • Best for: Brand colors, metallic inks, or colors requiring exact printing specifications
  • Note: Typically used for colors that need to match specific Pantone or custom ink colors

Convert to Solid Colors

  • Purpose: Creates regular process colors (non-global, non-spot)
  • Best for: Standard colors that don't need special printing treatment
  • Note: These are independent color instances with no special linking

Delete Selected Swatches

  • Purpose: Removes unwanted swatches from your document
  • Safety features: Protected system swatches (White, Black, [None], [Registration]) cannot be deletedConfirmation dialog prevents accidental deletionShows detailed results of the deletion process
  • Protected system swatches (White, Black, [None], [Registration]) cannot be deleted
  • Confirmation dialog prevents accidental deletion
  • Shows detailed results of the deletion process

➌ Execute the Conversion

  1. Click the OK button to proceed with your selected operation
  2. Click Cancel to close the dialog without making changes

After processing, you'll see a completion dialog showing:

  • Success count: Number of swatches successfully converted/deleted
  • Skipped items: Gradient and pattern swatches that cannot be converted
  • Errors: Any swatches that couldn't be processed
  • Protected swatches: System swatches that were skipped during deletion

➍ Important Notes

Gradient and Pattern Swatch Limitations

  • Gradient swatches and pattern swatches cannot be converted to Global or Spot colors
  • These will be automatically skipped during conversion with a detailed explanation
  • If you select only gradient/pattern swatches, you'll receive an informative alert

Swatch Group Preservation

  • The script maintains swatch group memberships after conversion
  • Converted swatches will remain in their original groups
  • Group structure is preserved across all conversion types

☻ Tips for Best Results

  1. Backup your work: Save your document before running mass conversions
  2. Organize first: Group related swatches before conversion to maintain organization
  3. Test small batches: Try converting a few swatches first to ensure desired results
  4. Use search wisely: Filter by naming conventions to convert related swatches together
  5. Check usage: Before deleting swatches, ensure they're not being used in your artwork

Leave a comment

Swatch Type Converter

Version: 1.0.3

Updated:

  • 1.0.0 – Initial release.
    1.0.1 – Added three buttons to the bottom of the Select swatches panel: Select All , Deselect All , and Invert Selection.
    1.0.3 – Enhanced the swatch selection interface with a custom scrollable view featuring real-time color previews.

    Tested on MacOS:

    • Adobe Illustrator 2023 (27.0)
    • Adobe Illustrator 2024 (28.1)
    • Adobe Illustrator 2025 (29.0)
  • Supported Versions:

    • Compatible with Adobe Illustrator CS6 and later, including Adobe Illustrator CC versions.

    Operating Systems:

    • Works on both macOS and Windows platforms.
  • End User License Agreement (EULA)

    Last Updated: 21.12.2024

    This End User License Agreement (“Agreement”) is a legal agreement between you (“User” or “Licensee”) and Samolevsky.com (“Licensor”) regarding the use of the Adobe Illustrator scripts (“Software”). By downloading, installing, or using the Software, you agree to be bound by the terms of this Agreement.

    1. Grant of License

    Licensor grants the User a non-exclusive, non-transferable, and revocable license to use the Software in accordance with this Agreement.

    • Free Software: If the Software is provided for free, you may use it for personal or commercial purposes without payment, subject to the restrictions outlined in this Agreement.
    • Paid Software: If the Software is provided for a fee, you may use it only after payment has been made in full.

    2. Usage Rights

    You are permitted to:

    • Install and use the Software on devices you own or control.
    • Use the Software in your personal or commercial projects, subject to compliance with this Agreement.

    3. Restrictions

    You may NOT:

    • Reverse engineer, decompile, or otherwise attempt to discover the source code, underlying ideas, or algorithms of the Software.
    • Reuse, incorporate, or integrate any portion of the Software into any other software, product, or project, except as expressly permitted by the Licensor in writing.
    • Resell, redistribute, or share the Software, whether in its original or modified form, without prior written consent from the Licensor.
    • Claim ownership of the Software or its underlying code.
    • Use the Software in any way that violates applicable laws or regulations.

    4. Ownership

    The Software and all intellectual property rights therein remain the exclusive property of the Licensor. This Agreement does not transfer ownership of the Software or any intellectual property rights to the User.

    5. Disclaimer of Warranties

    THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    6. Limitation of Liability

    To the maximum extent permitted by law, Licensor shall not be liable for any damages, including but not limited to direct, indirect, incidental, special, or consequential damages, arising out of or related to the use or inability to use the Software.

    7. Termination

    This Agreement is effective until terminated. Licensor may terminate this Agreement immediately if you breach any term of this Agreement. Upon termination, you must cease all use of the Software and destroy any copies in your possession.

    8. Updates and Support

    Licensor is not obligated to provide updates, support, or maintenance for the Software. However, updates may be provided at the sole discretion of the Licensor.

    9. Governing Law

    This Agreement shall be governed by and construed in accordance with the laws of the State of New York, without regard to its conflict of law principles.

    10. Entire Agreement

    This Agreement constitutes the entire agreement between you and the Licensor concerning the Software and supersedes all prior or contemporaneous understandings regarding such subject matter.

    By using the Software, you acknowledge that you have read this Agreement, understand it, and agree to be bound by its terms.

    For any questions or concerns regarding this Agreement, please contact us at hello@samolevsky.com

Browse More Scripts

  1. Explore Selection to HEX
    Selection to HEX

    Selection to HEX

    An Adobe Illustrator script that extracts HEX color codes from selected objects. Perfect for designers who need to quickly grab color palettes from their artwork.

    Explore
  2. Explore HEX to Swatches
    HEX to Swatches

    HEX to Swatches

    HEX to Swatches is a powerful and intuitive Adobe Illustrator script that streamlines your color workflow. Paste any list of HEX color codes — from raw text, #HEX notation, or even a Coolors.co palette URL — and instantly generate a named swatch group or a smooth gradient.

    Explore
  3. Explore Text Splitter
    Text Splitter

    Text Splitter

    Text Splitter is a powerful Adobe Illustrator script that allows you to split text frames into individual lines, words, or characters. 

    Explore

Introducing ScriptBox

Your Complete Adobe Illustrator Productivity Hub

Required Software

Adobe Illustrator

Adobe Illustrator is a professional vector graphics software developed by Adobe Inc. It is widely used by designers, illustrators, and artists for creating a variety of digital artwork, including logos, icons, illustrations, typography, and complex design layouts. Illustrator is known for its precision and scalability, allowing users to create high-quality graphics that can be resized without losing clarity. Its features include powerful drawing tools, customizable brushes, advanced typography options, and seamless integration with other Adobe Creative Cloud applications. Illustrator is a go-to tool for creative professionals working on projects for print, web, and multimedia platforms.

  • 🅰 Locating the Scripts Folder

    To install a Swatch Type Converter.jsx script in Adobe Illustrator, you need to place it in the correct directory where Illustrator
can recognize it. Follow these steps to locate the Scripts folder:

    1. MacOS:
      Open Finder and navigate to:
      Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts
    2. Windows:
      Open File Explorer and navigate to:
      C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts
    3. Replace <Version> with your Adobe Illustrator version (e.g., 2025).
    4. Replace <Language> with your language folder (e.g., "de_DE" for German, "en_US" for English).

    🅱 Installing the Script

    1. Copy the Script File: Copy the Swatch Type Converter.jsx file to the Scripts folder located in the path above.
    2. On some systems, you may need administrator permissions to modify the Scripts folder.
    3. Restart Adobe IllustratorTo refresh the scripts menu, close and reopen Adobe Illustrator.

    Explore our complete guide to mastering Adobe Illustrator scripts.

    1. Open Adobe Illustrator and ensure a document is active.
    2. Go to the top menu bar and select File > Scripts.
    3. If the script is installed in the Scripts folder, it will appear in the dropdown list.
    4. Click the Swatch Type Converter script to run it.
    5. The Swatch Type Converter script will execute, and any dialog boxes or results will appear based on the script’s functionality.

    ☻ Before running any scripts, it’s strongly advised to save your work — especially when working with complex or large documents.

Got questions?

Need help or have an idea to share? We’d love to hear from you! Whether you have questions, found a bug, have a feature request, or just want to share your feedback, reach out to us—we’re here for you!