Hue Saturation Lightness

Hue Saturation Lightness

Script for Adobe Illustrator

Overview

Hue Saturation Lightness is a powerful Adobe Illustrator script designed to give you complete control over the color properties of your selected paths and text objects. With this intuitive dialog window, you can effortlessly adjust the Hue, Saturation, and Lightness of your design elements, offering precise and customizable color transformations. 

Before / After

 

Installation

  • Place the script in your Illustrator Scripts folder:

    MacOS:
     /Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts
    Windows: C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts

  • Restart Adobe Illustrator to load the script into the File > Scripts menu.

Using the Script

  • Prepare Your Document:
    Ensure you have Adobe Illustrator open with at least one document active.

  • Select Objects:
    Select one or more objects on your artboard that you wish to adjust.

  • Run the Script:
    Go to File > Scripts > Hue Saturation Lightness to launch the script.

  • Interact with the Dialog Window:
    Upon running, a dialog window will appear with the following components:

 

 

➊ Hue Adjustment

The Hue (H) adjustment section of the script enables precise control over the color tone of selected objects by shifting their hues along the color spectrum.

Here’s a detailed breakdown of its functionality:

Hue Shifting Range

  • Adjust hues across a -180° to +180° spectrum.
  • Negative values: Shift colors counterclockwise (e.g., turning red toward purple).
  • Positive values: Shift colors clockwise (e.g., turning red toward orange).

Controls

  • Slider: Drag horizontally for intuitive adjustments. Changes apply instantly to selected objects
  • Input Field: Type exact values for precision (supports integers like 45, -90).
  • Arrow Keys: Press ↑/↓ in the input field for incremental changes. Hold Shift + ↑/↓ for larger increments (10 units per click).

Example Use Cases

  • Turn a blue logo green by shifting hue to +60°.
  • Correct color mismatches in imported artwork.

The Hue adjustment section is ideal for creative exploration, color correction, or harmonizing palettes, offering both flexibility and precision.


➋ Saturation Adjustment

The Saturation (S) adjustment section of the script allows users to control the intensity or vibrancy of colors in selected objects. It modifies how "pure" or "muted" a color appears, enabling both subtle tonal refinements and dramatic stylistic changes.

Below is a detailed breakdown of its functionality:

Saturation Range

  • Adjust saturation between -100% (desaturated) and +100% (oversaturated).
  • Negative values: Reduce intensity, creating muted/grayish tones (e.g., turning red into pink or gray).
  • Positive values: Amplify vibrancy, making colors more vivid (e.g., boosting a pale blue to a neon hue).
  • 0%: Leaves saturation unchanged.

Controls

  • Slider: Drag horizontally for smooth adjustments.
  • Input Field: Enter exact values (e.g., -30, +75) for precision.
  • Arrow Keys: Use ↑/↓ in the input field for incremental changes. Hold Shift + ↑/↓ for larger jumps (10 units per click).

Example Use Cases

  • Create a vintage look by reducing saturation to -40%.
  • Turn a muted logo into a vibrant brand asset by boosting saturation to +50%.
  • Balance oversaturated colors in imported vector artwork.
  • At -100%, colors become grayscale. 

The Saturation adjustment section is indispensable for achieving tonal harmony, correcting washed-out colors, or creating stylized effects like duotones or monochromatic palettes—all while maintaining a non-destructive, flexible workflow.


➌ Lightness Adjustment

The Lightness (L) adjustment section of the script enables users to modify the brightness or luminance of colors in selected objects. It controls how light or dark a color appears, allowing for nuanced tonal adjustments—from subtle highlights to dramatic contrast shifts.

Below is a detailed breakdown of its functionality:

Lightness Range

  • Adjust brightness between -100% (darken) and +100% (brighten).
  • Negative values: Reduce lightness, creating darker tones (e.g., turning blue into navy).
  • Positive values: Increase lightness, producing pastel or washed-out effects (e.g., turning red into pink).
  • 0%: Leaves lightness unchanged.

Controls

  • Slider: Drag horizontally for smooth adjustments.
  • Input Field: Type exact values (e.g., -20, +60) for precision.
  • Arrow Keys: Press ↑/↓ in the input field for incremental changes. Hold Shift + ↑/↓ for larger steps (10 units per click).

Example Use Cases

  • Create a dark theme by reducing lightness to -30%.
  • Simulate sunlight effects by increasing lightness to +40% on highlights.
  • Balance uneven lighting in complex vector illustrations.

The Lightness adjustment section is essential for refining contrast, simulating lighting effects, or harmonizing color palettes—all within a non-destructive workflow that prioritizes flexibility and precision.


➍ Finalizing Changes

Finalize or Cancel

  • Click OK to apply changes permanently.
  • Click Cancel to revert to original colors.

Tips

  • Real-Time Preview: Instantly see adjustments as you make them.
  • Non-Destructive Editing: Original colors remain unchanged until you confirm with OK.
  • Need help? Click the ⏼ icon at the bottom right to access the online user guide.

This script applies Hue, Saturation, and Lightness (HSL) adjustments to a variety of objects in Adobe Illustrator, including:

  • Paths/Compound Paths (Vector Shapes)
  • Text Frames
  • Groups
  • Gradients (Linear or Radial)
  • Color Modes (RGB, CMYK, Grayscale, and Spot Colors)


➎ Additional Notes

Exclusions/Limitations 

⚠︎ The script does not apply adjustments to:

✖ Raster Images.
✖ Pattern Swatches.
✖ Effects/Appearances.
✖ Freeform Gradients.
✖ Gradient Meshes

Overall, the Hue Saturation Lightness script streamlines color editing, offering flexibility for both subtle tweaks and dramatic transformations.

Whether you’re looking to tweak the vibrancy, shift colors, or create unique color schemes, this script streamlines the process, saving you time while achieving professional, visually appealing results. Perfect for designers seeking an efficient way to enhance color dynamics in their projects.ㅤ

Leave a comment

Hue Saturation Lightness

Version: 1.0.0

Updated:

    • 1.0.0 – Initial release.

    Tested on MacOS:

    • Adobe Illustrator 2023 (27.0)
    • Adobe Illustrator 2024 (28.1)
    • Adobe Illustrator 2025 (29.0.1)
  • 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

Use this text to share information about your brand with your customers. Describe a product, share announcements, or welcome customers to your store.

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 Hue Saturation Lightness.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 Hue Saturation Lightness.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 Hue Saturation Lightness script to run it.
    5. The Hue Saturation Lightness 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! 

Browse More Scripts

  1. Read more: Adjust Stroke Weight by Percentage
    Adjust Stroke Weight by Percentage

    Adjust Stroke Weight by Percentage

    The Adjust Stroke Weight by Percentage script for Adobe Illustrator allows users to proportionally scale the stroke weight of multiple selected objects. It provides a user-friendly dialog where you can input a percentage or use a slider to increase or decrease stroke widths. Additionally, the script offers an option to apply an average stroke width across all selected objects.
    Read more
  2. Read more: Hue Saturation Lightness
    Hue Saturation Lightness

    Hue Saturation Lightness

    Hue Saturation Lightness is a powerful Adobe Illustrator script designed to give you complete control over the color properties of your selected paths and text objects. With this intuitive dialog window, you can effortlessly adjust the Hue, Saturation, and Lightness of your design elements, offering precise and customizable color transformations.
    Read more
  3. Read more: Select by Size
    Select by Size

    Select by Size

    Select by Size is a powerful script for Adobe Illustrator that allows users to select objects based on their width and height ranges. Whether working with small icons or large design elements, this tool ensures precise control over selections, saving time and effort.
    Read more