Unit Converter

Script for Adobe Illustrator

ㅤ

Description

The Unit Converter script for Adobe Illustrator is a powerful and intuitive tool designed to streamline unit conversions directly within your workflow. This script provides real-time conversion between 10 different measurement units commonly used in design and print work, making it easy to work across different measurement systems without manual calculations.

ㅤ

10 Supported Units:

Pixels (px) - Digital screen measurements
Points (pt) - Traditional typography unit
Picas (pc) - Print layout measurements
Inches (in) - Imperial system
Feet (ft) - Imperial system
Yards (yd) - Imperial system
Millimeters (mm) - Metric system
Centimeters (cm) - Metric system
Meters (m) - Metric system

ㅤ

ㅤ

The script features a live conversion calculator where entering a value in any unit field instantly updates all other unit fields, allowing you to see equivalent measurements at a glance. Additionally, it can extract dimensions from selected objects in your document, making it perfect for quickly converting existing artwork measurements or planning new designs with specific dimensional requirements.

ㅤ

Key Features

Real-Time Conversion: Enter a value in any unit field and instantly see conversions across all supported units
Object Dimension Integration: Use width or height from selected objects as conversion base values
Multiple Object Support: Navigate through multiple selected objects to convert their dimensions
Document-Aware: Automatically detects and highlights your document's current ruler unit
Keyboard Shortcuts: Use Up/Down arrow keys to increment/decrement values (Shift for larger steps)

ㅤ

Installation

1. Download the Unit 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

4. Access the script via File > Scripts > Unit Converter

5. Alternatively, run it directly via File > Scripts > Other Script... and browse to the file location

Tip: You can also drag and drop the .jsx file directly onto the Illustrator workspace to run the script instantly – no installation needed.

ㅤ

Using the Script

ㅤ

🅰 Basic Usage: Manual Conversion

1. Launch the Script

Go to File > Scripts > Unit Converter
The Unit Calculator dialog will appear

ㅤ

2. Enter a Value

Click on any input field (or click its label to focus)
Type a numeric value
All other unit fields will automatically update with converted values

ㅤ

3. Use Keyboard Shortcuts

While focused on any input field:

Press Up Arrow to increase the value by 1
Press Down Arrow to decrease the value by 1
Hold Shift + Up/Down Arrow for increments of 5

ㅤ

4. Default Behavior

When opened, the calculator defaults to "1" in your document's current ruler unit
If no document is open, it defaults to 1 point (pt)

ㅤ

🅱 Advanced Usage: Converting Object Dimensions

When you have objects selected in your document, you can use their actual dimensions as the conversion base:

ㅤ

1. Select Object(s)

Select one or more objects in your Illustrator document
Run the script

ㅤ

2. Enable "Use Selected Object Value"

In the Options panel, check the "Use Selected Object Value" checkbox
The Width/Height radio buttons and Next Object navigation will become enabled

ㅤ

3. Choose Dimension

Select Width to convert the object's width
Select Height to convert the object's height
All unit fields will update to show the selected dimension in different units

ㅤ

4. Navigate Multiple Objects (if multiple objects are selected)

Click the ← (Previous) button to view the previous object's dimensions
Click the → (Next) button to view the next object's dimensions
The navigation cycles through all selected objects
Switch between Width/Height at any time to see different dimensions

ㅤ

5. Return to Manual Mode

Uncheck "Use Selected Object Value" to return to manual entry mode
The calculator will reset to 1 unit in your document's ruler unit

ㅤㅤ

Understanding the Interface

The Unit Calculator dialog is organized into several sections:

ㅤ

Main Conversion Area

Left Column: Unit labels (Pixels, Points, Picas, etc.)
Center Column: Input fields for entering/viewing values
Right Column: Unit symbols (px, pt, pc, etc.)

ㅤ

Options Panel

Use Selected Object Value: Toggle to use dimensions from selected objects
Width/Height: Choose which dimension to convert
Next Object: Navigation controls for multiple selections (← and → buttons)

ㅤ

Active Field Indicator

The input field matching your document's ruler unit will be automatically focused when the dialog opens
This makes it quick to start entering values in your preferred unit

ㅤ

☻ Wrap Up

This tool is designed to save you time and remove the guesswork from unit conversions. Thank you for using the Unit Converter script—we look forward to it becoming an essential part of your toolkit.

ㅤ

#Utility

Unit Converter

Version: 1.0.0

Updated: February 17, 2026

Download Unit Converter

1.0.0 – Initial release.
ㅤ
ㅤ
Tested on MacOS:
ㅤ
- Adobe Illustrator 2023 (27.0)
- Adobe Illustrator 2024 (28.1)
- Adobe Illustrator 2025 (29.8)
- Adobe Illustrator 2026 (30.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

More Adobe Illustrator Scripts

Explore Tints and Shades Generator

Tints and Shades Generator

Tints and Shades Generator allows you to instantly generate color palettes – including tints, shades, tones, Tailwind-style scales, transparency variations, and analogous harmonies.

Explore
Explore Page Number Generator

Page Number Generator

Page Number Generator is a powerful and intuitive script for Adobe Illustrator that automates the process of adding page numbers to your artboards.

Explore
Explore Symbol Transfer

Symbol Transfer

Symbol Transfer is an Adobe Illustrator script that streamlines the process of copying symbols between multiple open documents.

Explore

Introducing ScriptBox

Your Complete Adobe Illustrator Productivity Hub

Install Extension

➊ Toolbox

Access to 200+ pre-built scripts organized in categories.

➋ Script Launcher

Load and manage third-party scripts from custom folders.

➌ Panel Manager

Quick access to toggle Adobe Illustrator's built-in panels

➍ Favourites

Save frequently used scripts and panels for quick access.

➎ Code Editor

Write, edit, and execute custom ExtendScript/JavaScript code.

➏ Task Manager

An integrated to-do list that helps you track design tasks and jot down your ideas.

➐ Video Player

Create your own personal video library and watch YouTube videos right within the extension.

➑ Image Gallery

A visual moodboard allowing you to keep inspiration and reference materials right in your workspace while you design.

☻ Info

A heartfelt "Thank You" section to recognize our amazing Patreon supporters who help make ScriptBox possible.

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 Unit 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 Unit 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 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 Unit Converter script to run it.
5. The Unit 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.

🅰 Locating the Scripts Folder
To install a Unit 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 Unit 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 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 Unit Converter script to run it.
5. The Unit 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!

Ask a Qestion