Troubleshooting

This page lists common issues and practical fixes. If you still need help after trying the steps below, include:

• your IconGenerator version,

• your OS version,

• the icon set name involved (family + set),

• screenshots of the dialog or error message,

• and (for CLI) the full command line used (with paths anonymized if needed).

I can’t see some panels / my layout is messed up

Symptoms:

• the Generated Icons panel is missing,

• the Icon Collections panel is missing,

• panels are floating off-screen after switching monitors,

• the workspace looks “broken”.

Fix:

1. Re-enable the panels:

   • View ‣ Generated Icons Window F11

   • View ‣ Icon Collections Window F12

2. Restore the default layout:

   • View ‣ Restore Default Windows Positions

See also: Workspace overview.

I can’t export PDF/EPS/PS

Some IconGenerator configurations require an external application (commonly Inkscape) to generate PDF/EPS/PS.

Fix:

1. Install Inkscape.

2. Restart IconGenerator.

3. Retry the export:

   • From Generated Icons: File ‣ Create Generated Icon Files F3

   • From Collections: Collection ‣ Create Collection Icon Files… F4

If the format options remain unavailable in the export dialog, confirm Inkscape is correctly installed on the machine.

See also: Export formats and options.

I can’t export icon fonts (EOT/TTF/WOFF/OTF…)

Font export requires FontForge.

Fix:

1. Install FontForge.

2. Restart IconGenerator.

3. In the export dialog, enable Font Icons and (optional) Create CSS.

4. Export again (F3 or F4).

See also: Export formats and options and Command line usage.

Export runs but files are not created / output folder is empty

Most common causes:

• destination folder is wrong,

• you do not have write permissions,

• the export dialog was cancelled,

• you selected no output formats (or no bitmap sizes for bitmap formats).

Fix checklist:

1. Run the export command again:

   • File ‣ Create Generated Icon Files F3 (Generated Icons selection)

   • Collection ‣ Create Collection Icon Files… F4 (Collection export)

2. In the export dialog:

   • verify the destination path,

   • select at least one output format (SVG/XAML/PNG/…),

   • if you selected a bitmap format (PNG/BMP/JPG/ICO/ICNS), select at least one size.

3. Try exporting to a simple folder you fully control (example: your Desktop).

4. If you run exports repeatedly, check the preference:

   • Edit ‣ Preferences… F2 → General

   • Show dialog after generation of icon files

   If disabled, export can feel “silent” (no final confirmation dialog).

I get “Access denied” or permission errors when exporting

Fix:

• Export to a folder where you have full write permissions (for example inside your user profile).

• Avoid protected locations such as C:\Program Files\.

• On corporate machines, security policies may block writing to some folders.

On macOS, confirm you have granted file system access to IconGenerator if the OS prompts for it.

My icon sets look outdated / missing

Most common causes:

• automatic icon set updates are disabled,

• updates are blocked by a proxy/firewall,

• your sets are not activated (licensed) yet.

Fix:

1. Enable icon set auto-update:

   • Edit ‣ Preferences… F2 → Auto-Update

   • Enable Automatically Download/Update Icon Sets

2. Trigger an update check:

   • Help ‣ Check For Updates

3. If your network uses a proxy:

   • Edit ‣ Preferences… F2 → Internet

   • Enable Use Proxy with Authentication and enter credentials if required.

See also: Preferences and Updates and account.

A purchased icon set is not activated (still “Not licensed”)

Icon sets can be activated automatically when you sign in to your Axialis account.

Fix:

1. Sign in (click your name on the right side of the toolbar, if available).

2. Synchronize licenses:

   • Licenses ‣ Synchronize Licenses

3. If you received a license key instead of using an account:

   • Licenses ‣ Activate License (Enter Key)…

4. If sync fails in a corporate network, configure proxy settings:

   • Edit ‣ Preferences… F2 → Internet

See also: Licenses and icon set activation and Updates and account.

Find returns no results (or too many results)

No results:

• Try a shorter keyword or a synonym.

• Disable Search in activated and free sets only (it restricts the scope).

Too many results:

• Add a second word (example: document add).

• Enable Search in activated and free sets only to reduce the scope.

Tip: after searching, results appear in the Search Result folder in the Icon Sets tree. You can locate the original icon set of a result by right-clicking it and choosing Locate Icon in Set.

See also: Finding icons.

Overlay position shortcuts don’t do what I expect (F5–F8)

The overlay position shortcuts are focus-dependent:

• If focus is in the Icon Collections window, F5–F8 apply to selected collection icons.

• Otherwise, they apply to the selection in Generated Icons.

Fix:

• Click inside the panel you want to affect (collection list vs generated icon preview), then press the shortcut again.

See also: Adding Overlays.

Vector overlays look wrong in some frameworks (mask/clipping issues)

Some UI frameworks have limited support for certain SVG/XAML masking features.

Fix:

1. Open Preferences:

   • Edit ‣ Preferences… F2 → Overlays

2. Try switching overlay processing method:

   • Use Axialis Pathfinder Clipping (more compatible)

   • Use Clipping Masks (smaller files, but less compatible in some GUIs)

See also: Adding Overlays.

Color palettes I edited don’t appear / new palette not listed

Color palettes are loaded from the user palette folder.

Fix:

1. Confirm your .axpal file is in:

   %APPDATA%\Axialis\IconGenerator\Color Palettes

2. Confirm the XML is valid (palettes are plain text XML).

3. Restart IconGenerator if the palette menu does not refresh automatically.

See also: Colorizing icons.

My edited icon doesn’t update in IconGenerator

If you edit an icon in an external SVG editor and the preview does not refresh:

Fix:

1. Make sure you saved the file in the external editor.

2. Reselect the icon in IconGenerator (click another icon and click back).

3. If needed, close and reopen the collection/document.

4. Ensure you edited the copy, not the original (IconGenerator always edits copies).

Edited icons are stored in:

C:\Users\<username>\Documents\Icons\

See also: Editing icons.

Command line generation fails / does nothing

Fix checklist:

1. Verify the collection file exists and is accessible:

   • -g <file> or /g <file>

2. Verify the destination folder exists (or can be created) and is writable:

   • -d <folder> or /d <folder>

3. Select at least one output format (example: /svg or /png).

4. If you selected bitmap output, include at least one size option (example: /s32p or /s2x).

5. Use verbose logging:

   • --verbose

6. Hide the progress window in unattended runs:

   • --hide-progress or /hp

Color arguments: remember to quote #RRGGBB in shells where # starts a comment (PowerShell, bash/zsh):

icongenerator -g c:\coll.axicp -d d:\icons /svg /ic "#33FF99" /oc "#33FF99" --verbose

See also: Command line usage.

Updates fail (no connectivity)

Fix:

1. Try manual update:

   • Help ‣ Check For Updates

2. If you are behind a proxy:

   • Edit ‣ Preferences… F2 → Internet

   • Enable Use Proxy with Authentication

3. If your company firewall blocks downloads, allow IconGenerator access (or use an approved network).

See also: Updates and account.

Quick reference (shortcuts)

• Preferences: F2

• Find icons: Ctrl+F

• Export Generated Icons to disk: F3

• Export Collection to disk: F4

• Toggle Generated Icons window: F11

• Toggle Icon Collections window: F12

• Overlay position: F5–F8 (focus dependent)

• Properties: Alt+Enter

See also: Keyboard shortcuts.