GuideMi User Manual

Overview

GuideMi is a guide management plugin designed for Adobe Illustrator. The plugin provides a comprehensive set of tools for creating, managing, and organizing guides. Whether you need simple border guides or complex grid layouts, GuideMi helps you set up guides quickly and precisely.

The plugin supports multiple units (pixels, centimeters, millimeters, inches, points, picas), intelligently positions guides based on selected objects, artboards, or document boundaries, and offers real-time preview functionality for more intuitive layout design. GuideMi also features a comprehensive multilingual interface supporting 17 languages, making it accessible to users worldwide.

Main Features

Smart Boundary Detection

All guide functions in GuideMi support smart boundary detection, determining the guide positioning area in the following priority order:

  1. Selected Objects First: If objects are selected, guides will be created based on the combined bounds of the selected objects
  2. Artboard Bounds: If no objects are selected, guides will be based on the active artboard bounds

Clipping Mask Support

GuideMi uses visible bounds when calculating object boundaries. For clipped groups (e.g., images placed with clipping masks), guides are positioned based on the visible clipping area rather than the full underlying content. This ensures accurate guide placement for masked images and complex compound paths.

Automatic Theme Matching

GuideMi automatically matches the Illustrator interface theme. When you change the UI brightness in Illustrator's Preferences, the plugin panel seamlessly switches between dark and light themes without any manual action required.

Quick Actions

The Quick Actions area is located at the top of the plugin, providing the most commonly used guide functions arranged in an 8-column, 4-row layout.

Row 1: Single-Edge Guides and Basic Layouts

IconButtonFunctionDetailed Description
TopTop GuideAdd a horizontal guide at the top edge of the target area. Right-click to access object mode options
BottomBottom GuideAdd a horizontal guide at the bottom edge of the target area
LeftLeft GuideAdd a vertical guide at the left edge of the target area
RightRight GuideAdd a vertical guide at the right edge of the target area
H-CenterHorizontal CenterAdd a horizontal guide at the vertical center of the target area
V-CenterVertical CenterAdd a vertical guide at the horizontal center of the target area
BorderBorder GuidesAdd border guides around all four edges of the target area
MidlinesCenter CrossAdd both horizontal and vertical center guides simultaneously

Multi-Object Behavior (Right-Click Menu)

The right-click menu on the button provides options to control how guides are created when multiple objects are selected:

This setting is global and affects all guide creation functions throughout the plugin.

Row 2: Grid Presets and Composition Guides

IconButtonFunctionDetailed Description
2×22×2 GridQuickly create a 2-row, 2-column evenly divided grid
3×33×3 GridQuickly create a 3-row, 3-column evenly divided grid (rule of thirds)
4×44×4 GridQuickly create a 4-row, 4-column evenly divided grid
5×55×5 GridQuickly create a 5-row, 5-column evenly divided grid
6×66×6 GridQuickly create a 6-row, 6-column evenly divided grid. Right-click to select 7×7, 8×8, 9×9, or 10×10 grids
φ Golden RatioGolden RatioAdd golden ratio guides (two lines each in horizontal and vertical directions, positioned at 38.2% and 61.8%, calculated based on golden ratio φ ≈ 1.618). Right-click to select different variants
4:34:34:3 Aspect RatioCreate a 4:3 aspect ratio guide frame based on the target area. Right-click to set custom aspect ratio
16:916:916:9 Aspect RatioCreate a 16:9 aspect ratio guide frame based on the target area

Golden Ratio Variants (Right-Click Menu)

Custom Aspect Ratio (Right-Click Menu)

Right-clicking on the 4:3 button opens a custom aspect ratio panel where you can:

Row 3: Units, Tools, and Display Controls

IconButtonFunctionDetailed Description
ptUnitUnit ToggleClick to cycle through units: pt → px → mm → cm → in → pica. Scroll wheel for bidirectional switching, long-press to reset to Points (pt), right-click to show full unit list
Place Guide (Pen)Place Guide by ClickClick the button to enter pen pick mode, then click anywhere on the canvas to place guides at that position. Right-click to choose line direction: Both (Crosshair), Horizontal Only, or Vertical Only
SpotlightSpotlight ModeAutomatically create guides at the boundaries of the currently selected objects, updating automatically when the selection changes. Click to cycle: Off → Edge Mode → Midline Mode → Off
LockLock GuidesToggle the lock state of guides; when locked, guides cannot be moved
Toggle GuidesShow/HideToggle the visibility of guides
xyPlace GuidePlace Guide (X,Y)Click or right-click to open coordinate input panel. Enter X and Y values to place guides at a specific position. Three placement options: crosshair (both H+V), horizontal only, or vertical only
Guide ColorGuide ColorNot available in Illustrator (Photoshop only)
Guide StyleGuide StyleNot available in Illustrator (Photoshop only)

Place Guide (Pen)

The Place Guide (Pen) feature allows you to place guides by clicking directly on the canvas:

  1. Click the Place Guide (Pen) button — the cursor switches to the Pen Tool and the button highlights
  2. Click anywhere on the canvas — a guide is placed at the clicked position and the tool automatically switches back to the Selection Tool
  3. If no click is made within 30 seconds, pen pick mode is automatically cancelled
  4. Right-click the button to choose line direction:
    • Both (Crosshair): Place both horizontal and vertical guides (default)
    • Horizontal Only: Place only a horizontal guide
    • Vertical Only: Place only a vertical guide

This feature requires Adobe Illustrator CC 2020 (v24) or later due to the app.selectTool() API requirement.

Place Guide (X,Y)

The Place Guide feature allows you to create guides at precise coordinates:

  1. Click the Place Guide button (or right-click) to open the coordinate input panel
  2. Enter X and Y values in the current unit
  3. Click one of three buttons to place guides:
    • Cross: Place both horizontal and vertical guides at the specified position
    • H: Place only a horizontal guide at the Y position
    • V: Place only a vertical guide at the X position

Coordinates are relative to the top-left corner of the active bounds (selected objects or artboard).

Spotlight Mode

Spotlight is a dynamic guide feature particularly useful for the following scenarios:

When Spotlight is enabled, guides will continuously track the currently selected objects until manually turned off.

Row 4: Clear Guides and Global Controls

IconButtonFunctionDetailed Description
ClearClear AllClear all guides in the document. Shortcut: Delete
Clear H-GuidesClear HorizontalClear only horizontal guides
Clear V-GuidesClear VerticalClear only vertical guides
Clear OutsideClear Outside CanvasClear guides located outside the canvas boundaries
Clear on CanvasClear on CanvasClear guides located within the canvas boundaries
Clear on ObjectsClear on ObjectsClear guides that overlap with the currently selected objects. Right-click to access additional options. Requires at least one object to be selected
Keep/Clear ToggleKeep/Clear ToggleToggle Quick Actions behavior: (green) keeps existing guides, (red) clears before creating
Collapse AllCollapse/ExpandCollapse or expand all function panels

Clear on Objects Options (Right-Click Menu)

Right-clicking on the button provides additional clearing options:

Clear Button Status Indicators

Clear buttons dynamically display status based on whether corresponding guide types exist:

Margin-Go-Round

Margin-Go-Round takes its name from "Merry-Go-Round" (Carousel), suggesting guides that surround the target area. This tool creates guides with margins around target areas, perfect for quickly setting up safe margins or padding layouts.

Workflow

  1. Define Target Area: Select objects, or use the active artboard
  2. Set Margin Values: Enter margin values for top, bottom, left, and right
  3. Execute: Click the button to create margin guides

Control Descriptions

Margin Inputs

ControlFunction
Left IconLeft margin label, supports drag-to-adjust value
Left InputLeft margin value
Right IconRight margin label, supports drag-to-adjust value
Right InputRight margin value
Top IconTop margin label, supports drag-to-adjust value
Top InputTop margin value
Bottom IconBottom margin label, supports drag-to-adjust value
Bottom InputBottom margin value

Action Buttons

IconButtonFunction
LinkLink/unlink all four margin values. When linked , changing any margin value updates all four margins to the same value
PreviewEnter/exit preview mode for real-time guide preview. Red when inactive, green when active. Press Esc to exit
Keep/ClearToggle whether to keep existing guides when creating new ones
ResetReset all margin values to 0. If a ★ default preset is set in Grid-and-Go, loads that preset instead
GoCreate margin guides

Link Margins

The Link button controls whether margin values are synchronized:

This is useful when you need equal margins on all sides — simply link them and adjust any one value.

Margin Value Explanation

Value Adjustment Methods

Margin inputs support multiple adjustment methods:

Grid-and-Go

Grid-and-Go takes its name from "Grab-and-Go," suggesting quick grid layout creation. This tool creates custom grid guides with support for row/column counts and gutters, and can create corresponding shapes.

Workflow

  1. Define Target Area: Select objects, or use the active artboard
  2. Set Grid Parameters: Enter column count, row count, column gutter, and row gutter
  3. Execute: Click the button to create grid guides

Control Descriptions

Grid Parameters

ControlFunction
Rows IconRow count label. Click to increment by 1, Alt+click to decrement by 1, long-press to reset to default. Also supports drag-to-adjust value
Rows InputNumber of rows (1-50)
Col. IconColumn count label. Click to increment by 1, Alt+click to decrement by 1, long-press to reset to default. Also supports drag-to-adjust value
Columns InputNumber of columns (1-50)
Row Gutter IconRow gutter label, supports drag-to-adjust value
Row Gutter InputSpacing between rows
Col. Gutter IconColumn gutter label, supports drag-to-adjust value
Column Gutter InputSpacing between columns

Action Buttons

IconButtonFunction
ShapesCreate filled rectangular shapes in each grid cell (checkerboard pattern of black and white)
Consider MarginToggle whether to apply Margin-Go-Round margins when creating the grid. When enabled , the grid is created within the margin area
Save PresetSave current settings as a preset
Import PresetImport presets from JSON file
Load PresetLoad a saved preset. Click ★ to set a default preset that loads on startup and when Reset is clicked
PreviewEnter/exit preview mode for real-time guide preview. Red when inactive, green when active. Press Esc to exit
Keep/ClearToggle whether to keep existing guides when creating new ones
ResetReset all grid parameters to default values. If a ★ default preset is set, loads that preset instead
GoCreate grid guides

Shapes

The Shapes button creates filled rectangular shapes in each grid cell with a checkerboard pattern (alternating black and white). The shapes are created on a new "Grid Shapes" layer. This feature is primarily used for quickly creating image layout templates, particularly suitable for scenarios requiring batch image processing (such as microscope photos or experimental results in scientific papers). Use the "Replace Contents" feature to quickly replace shapes with images for rapid batch image layout.

Typical workflow: Set grid parameters → Click Shapes to create template → Batch replace shapes with images → Layout complete

Consider Margin Toggle

The Consider Margin button controls whether the grid respects the margins set in Margin-Go-Round:

Load Preset Button

Click the button to show the preset menu:

In the preset menu:

Preview Mode

Preview mode allows you to view guide effects in real-time:

  1. Click the Preview button to enter preview mode (button turns green, eye icon changes to )
  2. Adjust any parameter to see guides update in real-time
  3. Click the button to confirm creation, or click Preview again to cancel
  4. Press Esc to quickly exit preview mode

Some Guides Like You

Some Guides Like You captures the current guide layout as a percentage-based snapshot, allowing you to save, export, import, and reapply guide arrangements across documents or artboards — perfect for maintaining consistent layouts across multiple files or artboards, or sharing guide templates with your team.

Workflow

  1. Set up guides in your document (manually or using other GuideMi tools)
  2. Set the Scope and Direction Filter to control which guides are captured. These settings are saved with the preset.
  3. Click to capture and store the current guide arrangement as a named preset
  4. Later, use to reapply a saved or recent layout, or to load from a file

Control Buttons

ButtonFunctionDescription
Apply to AllBatch applyCaptures guides from the current document (filtered by scope and direction) and applies them to all targets. Right-click to choose the target: Other Documents (default, applies to all other open documents; requires at least two open documents) or Other Artboards (applies to all other artboards within the same document; requires at least two artboards). The Keep/Clear toggle controls whether existing guides in each target are preserved or cleared.
ScopeToggle scopeSwitch between Artboard Only (captures/applies only guides within the active artboard bounds) and All Guides (includes guides outside the artboard). Applies to save and apply-to-all operations; when loading or importing, the preset's stored scope is used instead and this button is updated automatically.
Direction FilterToggle directionCycle through H + V, Horizontal Only, and Vertical Only. Click to cycle, long-press to reset to H + V, right-click for direct selection from a context menu.
Save LayoutCapture & saveCaptures the current guides (filtered by scope and direction) and saves them as a named preset. The current Scope and Direction Filter settings are stored with the preset. Optionally exports to a JSON file for sharing.
Import LayoutImport from fileOpens a JSON file, saves it as a preset, and immediately applies the layout. Uses the scope and direction filter stored in the file.
Load LayoutLoad presetOpens the preset list to select and apply a saved or recent layout. The Scope and Direction Filter buttons are automatically updated to match the preset's stored settings. Single-click to apply, double-click to rename, click ★ to set as default, click × to delete.
Keep/ClearToggle modeGreen (): Keep existing guides when applying. Red (): Clear all guides before applying.
ResetReset settingsResets scope, direction filter, target mode, and keep/clear toggle to their default values. If a ★ default preset is set, loads that preset instead.

Scope and Direction Filter

The Scope and Direction Filter buttons control which guides are included in each operation. When saving, only guides matching the current scope and direction filter are captured into the snapshot, and the current Scope and Direction Filter settings are stored with the preset. When loading or importing, the preset's stored Scope and Direction Filter settings are used, and the UI buttons are updated to reflect them. When applying to all, the current Scope and Direction Filter settings are used (since this is a live capture-and-apply operation). This means each saved layout remembers its own scope and direction filter. For example, a layout saved with "Horizontal Only" will always apply only horizontal guides when loaded, regardless of the current button state.

Pixel-Perfect Mode

When the target artboard has the same dimensions as the source (where guides were originally captured), guides are applied at their exact point positions. When dimensions differ, guides are repositioned proportionally based on their percentage offsets, ensuring the layout adapts to the new artboard size.

Preset Management

The Load Layout dropdown shows two sections:

Both sections support: single-click to load and apply, double-click to rename, click ★ to set a saved preset as default (loads on startup and when Reset is clicked; click again to unset), and × to delete.

Geek-Set-Go

Geek-Set-Go takes its name from "Ready, Set, Go," designed for power users who need advanced unequal grid layouts. This tool allows you to create guides with custom ratios or absolute values, offering maximum flexibility for complex layout requirements.

Workflow

  1. Define Target Area: Select objects, or use the active artboard
  2. Enter Values: Input ratio or absolute values in the text field
  3. Configure Options: Set mode, direction, and other options
  4. Execute: Click the button to create guides

Input Syntax

Ratio Mode (Default)

In Ratio Mode, values represent proportional divisions of the target area:

InputResult
3Divides into 3 equal parts (like 1;1;1)
1;2;1Divides in 1:2:1 ratio (25%, 50%, 25%)
1;1;2Divides in 1:1:2 ratio (25%, 25%, 50%)
1;2;3Divides in 1:2:3 ratio

Absolute Mode

In Absolute Mode, values represent actual distances in the current unit:

InputResult
50Creates a guide every 50 units, repeating until space runs out
50;100Alternates between 50 and 100 unit segments
50;*;5050 units from start, remaining space in middle (*), 50 units at end
100;*;100;*;100Three 100-unit segments with flexible space between
50;*;*;5050 units at start, remaining space divided equally into 2 parts, 50 units at end
100;*;*;*;100100 units at each end, remaining space divided equally into 3 parts

The * (asterisk) acts as a wildcard for "remaining space" and is only available in Absolute Mode. Multiple asterisks divide the remaining space equally among them. For example, 50;*;*;50 creates 50-unit margins on each side with the middle space split into two equal parts.

Control Buttons

IconButtonFunction
ModeToggle between Ratio Mode and Absolute Mode
MarginToggle whether to consider Margin-Go-Round margins when calculating guide positions
DirectionSet guide direction. Click to cycle, scroll wheel for quick switching, long-press to reset to LTR, right-click for full menu
Save PresetSave current configuration as a named preset
Import PresetImport preset from JSON file
Load PresetLoad a saved preset. Click ★ to set a default preset that loads on startup and when Reset is clicked
Keep/ClearToggle whether to keep or clear existing guides before creating new ones
ResetReset all settings to defaults. If a ★ default preset is set, loads that preset instead
GoApply the guides

Direction Options

Single-axis directions:

Combined directions (for 2D layouts):

Preset Management

Geek-Set-Go has its own preset system, separate from Grid-and-Go:

Examples

Example 1: Magazine Layout (Ratio)

Example 2: Fixed Margins (Absolute)

Example 3: Equal Divisions (Ratio)

Example 4: Multiple Flexible Spaces (Absolute)

Artboard Selector

Located at the bottom of the plugin panel, the Artboard Selector allows you to switch between artboards in documents with multiple artboards.

ControlFunction
Artboard Tool ButtonClick to refresh the artboard list
DropdownSelect and switch to a different artboard
Reset ButtonRefresh the artboard list to sync with the current document

When you switch artboards, all guide operations (creation, clearing, preview) will target the newly selected artboard.

Flyout Menu

Click the hamburger menu icon (☰) in the top-right corner of the plugin panel to access the Flyout Menu.

Menu Items

ItemFunction
HelpOpens the user manual in the system default browser (automatically selects Chinese or English version based on the current interface language)
About GuideMiShows version information, author credits, and copyright notice
Cite This PluginShows a citation string for use in the legends and Materials & Methods sections of academic papers. Click to copy to clipboard
Check for UpdatesConnects to the SciSuite server to check whether a newer version is available. If a new version is found, the release notes are displayed and the download page opens automatically in your browser
Join UsLearn how to contribute to this project; the contact email is automatically copied to clipboard
Deactivate LicenseUnbind the license from this device and show the registration screen. Use this to transfer your license to another computer
LanguageSelect interface language from 17 available options

Available Languages

The plugin supports the following languages:

  1. 简体中文 (Simplified Chinese)
  2. 繁體中文(中國台灣)(Traditional Chinese — Taiwan)
  3. 繁體中文(中國香港)(Traditional Chinese — Hong Kong)
  4. 日本語 (Japanese)
  5. 한국어 (Korean)
  6. العربية (Arabic)
  7. Indonesia (Indonesian)
  8. Deutsch (German)
  9. English
  10. Español (Spanish)
  11. Español — Latinoamérica (Latin American Spanish)
  12. Français (French)
  13. Italiano (Italian)
  14. Português (Brasil) (Portuguese — Brazil)
  15. Português (Portugal) (Portuguese — Portugal)
  16. Русский (Russian)
  17. Türkçe (Turkish)

Language selection is saved and persists between sessions.

General Operation Guide

Button Interaction Modes

Many buttons in this plugin support multiple interaction methods:

Drag-to-Adjust Values

Icon buttons for grid and margin parameters support drag adjustment:

Scroll Wheel Value Adjustment

When hovering over numeric input fields, use scroll wheel to adjust values:

Unit System

GuideMi supports the following units; all margin and gutter values are converted based on the current unit:

UnitNameStep Value
ptPoints1
pxPixels1
mmMillimeters1
cmCentimeters0.1
inInches0.125
picaPicas0.5

The default unit is Points (pt). The unit cycle order matches the table above: pt → px → mm → cm → in → pica.

Preset Management

Grid-and-Go and Geek-Set-Go both support preset management:

When exporting presets, you can choose to export to a file for team sharing.

Section Collapse State

Click a Section header to collapse/expand that area; collapse state is automatically saved and restored when the plugin is reopened.

Progress Bar Feedback

When executing time-consuming operations (such as creating grid guides or Shapes), the Section header displays an animated indeterminate progress bar at the bottom, providing visual feedback that the operation is in progress.

Keyboard Shortcuts

ShortcutFunction
DeleteClear all guides
EscapeExit preview mode
TabCycle focus through buttons and input fields

FAQs

Q: Why aren't guides created at the expected position?

A: GuideMi determines guide positions in the priority order: Selected Objects > Artboard. Please check:

  1. Whether unexpected objects are selected (click an empty area to deselect)
  2. Whether the active artboard is correct
  3. If no objects are selected, guides will be based on the active artboard bounds

Q: How do I create guides at a specific position precisely?

A: Use the Place Guide (X,Y) feature:

  1. Click the Place Guide button to open the coordinate input panel
  2. Enter X and Y coordinates in the current unit
  3. Click the for both horizontal and vertical guides, or / for a single guide
  4. Coordinates are relative to the top-left corner of the active bounds

Q: Parameters don't respond in preview mode?

A: Please ensure:

  1. The Preview button is in active state (green)
  2. A document is open in Illustrator
  3. Parameter values are within valid ranges

Q: How do grid guides and margin guides work together?

A: Margin-Go-Round and Grid-and-Go can work together:

  1. First set margins in Margin-Go-Round
  2. Then set grid parameters in Grid-and-Go
  3. Enable the "Consider Margin" toggle in Grid-and-Go
  4. When creating the grid, margins are automatically applied; the grid will be created within the margin area

Q: What's the difference between Grid-and-Go and Geek-Set-Go?

A:

Q: How do I quickly restore default settings?

A:

Q: Where are presets saved?

A: Presets are saved in the GuideMi folder under your user data directory. Use the export feature to save presets as JSON files for backup or team sharing.

Q: How do I change the interface language?

A: Click the hamburger menu (☰) in the top-right corner of the plugin panel, then select your preferred language from the Language section. The setting is saved automatically.

Q: When importing a preset, are existing guides cleared or kept?

A: The behavior when importing a preset depends on the current Keep/Clear toggle state:

This applies to both Grid-and-Go and Geek-Set-Go preset imports. Check the Keep/Clear toggle before importing if you need specific behavior.

Q: How do I create guides for multiple objects at once?

A: Select multiple objects, then use any guide function. Right-click on the button to choose:

This setting is global and persists until changed.

Q: How do I activate the plugin after purchasing a license?

A: After purchasing, you will receive a license key via email. In the registration screen that appears when the plugin starts:

  1. Click the Activate button
  2. Enter the email address used for purchase and the license key
  3. Click Activate to confirm

Once activated, the registration screen will no longer appear on startup.

Q: How do I transfer my license to another computer?

A: Open the Flyout Menu (☰) and select Deactivate License. This unbinds the license from the current device. You can then activate the same license key on a different computer.

Q: The plugin shows the registration screen even though I already activated it?

A: This may happen if:

Try re-entering your license key via the Activate button. If the issue persists, contact support.

Version Information