Document Cleaner

Document Cleaner

Script for Adobe Illustrator

ㅤ

Description

The Document Cleaner is a comprehensive Adobe Illustrator script designed to help users clean up and optimize their files. It provides a collection of utility functions for removing unnecessary elements, simplifying document structure, and maintaining file organization.

Ideal for designers preparing files for print, export, or handoff, this script ensures your projects are clutter-free and professional.

ㅤ

Installation

1. Download the Document Cleaner.jsx script file

2. Place it 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.

4. Go to File > Scripts > Document Cleaner.

5. The dialog window will appear with the following options:

ㅤ

 

Using the Script

  • Browse or search for the desired function.
  • Select the function from the list.
  • Click "?" button to see a brief description of the function.
  • Click "OK" to execute the function (or just double-click).
  • Review the confirmation/result dialog that appears.

ㅤ

Available Cleaning Functions

Here's a breakdown of the main functions included in the Document Cleaner script:

ㅤ

Remove Unnecessary Elements

  • Delete Empty Text Frames: Removes text frames with no content.
  • Delete All Stray Points: Eliminates single anchor points that don't form paths.
  • Delete Duplicate Paths: Finds and removes redundant paths with identical properties.
  • Delete Unpainted Objects: Removes objects without fill or stroke.
  • Delete Transparent Objects: Removes objects with 0% opacity.
  • Delete Unneeded Points: Simplifies paths by removing unnecessary anchor points.
  • Delete Redundant Points: Merges anchor points that are extremely close together.
  • Delete Off-Artboard Objects: Removes items that fall outside all artboards.

ㅤ

Organize Document Structure

  • Delete Empty Artboards: Removes artboards that don't contain any artwork.
  • Delete Empty Layers: Removes layers that don't contain any objects.
  • Delete Hidden Layers: Removes layers that are currently hidden.
  • Delete Locked Layers: Removes layers that are currently locked.
  • Ungroup All Groups: Flattens nested groups while preserving clipping masks.
  • Ungroup Unnecessary Groups: Removes groups that contain only a single item, or no items at all.

ㅤ

Clean Up Presets

  • Delete All Swatches: Removes all color swatches from the Swatches panel.
  • Delete All Symbols: Removes all symbols while preserving their instances as regular artwork.
  • Delete Unused Symbols: Removes only symbols that aren't used in the document.
  • Delete All Guides: Removes all ruler guides from the document.

ㅤ

Document Management

  • Embed All Linked Files: Converts all linked images to embedded images.
  • Make All Layers Visible: Shows all hidden layers.
  • Unlock All Layers: Unlocks all locked layers.
  • Reset Raster Image Transformations: Removes any scaling, rotation, or skewing applied to images.

ㅤ

Additional Notes:

  • Click the ⏼ icon at the bottom right side of the panel to open the script’s user guide online.
  • Resize the dialog window to show more options at once.
  • Save your document before running cleaning operations.

ㅤ

ㅤ

The Document Cleaner script transforms tedious manual cleanup into a seamless, one-click process, saving time and ensuring polished Illustrator documents.

Whether tidying up before export, optimizing file size, or streamlining collaboration, this tool keeps your workflow efficient and error-free. Harness its power to focus on creativity—not clutter.

ㅤ

ㅤ

Leave a comment

Document Cleaner

Version: 2.0.2

Updated:

Download Document Cleaner

  • 1.0.0 – Initial release.
    2.0.0 – The new version of the Document Cleaner script features a completely redesigned user interface and expanded functionality.
    2.0.1 – New Delete Locked Layers option helps you clean up your document by automatically identifying and removing locked layers.
    2.0.2 – New Reset Raster Image Transformations option removes any scaling, rotation, or skewing applied to raster images.

    ㅤ

    ㅤ

    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

Required Software

Adobe Illustrator

Learn more

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 Document Cleaner.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 Document Cleaner.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 Illustrator: To 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 Document Cleaner script to run it.
    5. The Document Cleaner 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! 

Ask a Qestion

Browse More Scripts

More Adobe Illustrator Scripts
  1. Read more: Bento Grid Generator
    Bento Grid Generator

    Bento Grid Generator

    The Bento Grid Generator is a powerful script for Adobe Illustrator that allows designers to quickly create beautiful, customizable grid layouts inspired by the "bento box" style design pattern.

    Read more
  2. Read more: QR Code Generator
    QR Code Generator

    QR Code Generator

    QR Code Generator is a lightweight, time-saving script for Adobe Illustrator that lets you instantly generate scalable vector QR codes directly within your document. Perfect for designers working on packaging, print, branding, or web assets, this script eliminates the need to rely on third-party websites or tools.

    Read more
  3. Read more: Calculator
    Calculator

    Calculator

    This script creates a calculator panel within Adobe Illustrator, providing a convenient way to perform calculations without leaving the application.

    Read more

Shop More Creative Assets