Working with Collections

Collections are project documents (.AXICP) used to build and maintain a curated set of icons for an application. They are especially useful when you need:

  • a consistent icon list shared across a team,

  • multiple variants of the same icon (different overlays, colors, positions),

  • repeatable exports as the project evolves.

A collection stores more than “a list of icons”: it also keeps per‑icon settings such as overlay position, colorization, background, and resource identifiers.

Show the Icon Collections window

Collections are displayed in the Icon Collections window (panel). If the panel is hidden, show it with:

  • View ‣ Icon Collections Window F12

Tip

If your window layout becomes difficult to use (panels moved off‑screen, overlapping, etc.), restore the default layout with View ‣ Restore Default Windows Positions.

IconGenerator main window showing the collections area

Collections are displayed as tabbed documents in the main window.

Create, open, save and close collections

Create a new collection

  • File ‣ New Icon Collection Ctrl+N

Open an existing collection

  • File ‣ Open… Ctrl+O

  • File ‣ Recent Files

Save a collection

  • File ‣ Save Ctrl+S

  • File ‣ Save As…

Close a collection

  • File ‣ Close Ctrl+F4

Add icons to a collection

You can add icons in several ways depending on your workflow.

Drag & drop from the icon list

You can drag base icons directly from the icon list to the collection:

  1. Select one or more icons in the icon list.

  2. Drag the selection and drop it into the collection.

This is useful when you already know which base icons you want and you plan to apply overlays later.

Double-click to add

Double‑click an icon in the icon list to add it to the current collection.

This is a fast “browse and pick” workflow: browse a category and double‑click icons to insert them.

Apply overlays to icons in a collection

Overlays can be applied directly to icons already in the collection.

Drag & drop an overlay onto a collection selection

  1. Select one or more icons in the collection.

  2. Drag an overlay from the Overlays panel.

  3. Drop it onto the selected icons.

The overlay is applied immediately to the selection.

Double-click an overlay

If one or more icons are selected in the collection, double‑clicking an overlay applies it to that selection.

Remove overlays

Remove overlays from selected icons using:

  • Collection ‣ Remove Overlay

The same command is also available from the collection context menu (right‑click selection).

Change overlay position

Overlays can be placed in one of four corners. When you work in a collection, you can change overlay position for the selected icons using either the Collection menu or the collection context menu:

  • Collection ‣ Overlay Position: Top-Left F5

  • Collection ‣ Overlay Position: Top-Right F6

  • Collection ‣ Overlay Position: Bottom-Left F7

  • Collection ‣ Overlay Position: Bottom-Right F8

Overlay positions in the four corners

The four possible overlay positions.

Note

The shortcuts F5 to F8 are focus‑dependent: they apply to collection icons when the collection has focus, otherwise they apply to generated icons.

Organize icons in a collection

Reorder with the mouse

You can reorder icons by dragging them to a new position inside the collection. This is useful to keep icons grouped logically (for example by feature area).

Duplicate with Ctrl + Drag & Drop

To duplicate an icon (or a group of icons) inside the collection:

  1. Select the icon(s).

  2. Hold Ctrl.

  3. Drag and drop to a new position.

A copy is created. You can then adjust properties (name, overlay, colors…) to create variants.

Cut / Copy / Paste / Delete

Standard editing commands work on the selected collection icons:

  • Edit ‣ Cut Ctrl+X

  • Edit ‣ Copy Ctrl+C

  • Edit ‣ Paste Ctrl+V

  • Edit ‣ Delete Del

The same commands are also available from the collection context menu.

Select all / none

  • Edit ‣ Select All Ctrl+A

  • Edit ‣ Select None Shift+Ctrl+A

Sort

Sort the collection icons with:

  • Collection ‣ Sort ‣ Ascending

  • Collection ‣ Sort ‣ Descending

The Sort submenu is also available from the collection context menu.

Rename, numbering, and resource identifiers

Collections are designed for project workflows, so you can assign names and identifiers that match your code and resource conventions:

  • Name: user‑friendly name for the icon.

  • Resource ID: symbolic identifier often used in code or resource scripts.

  • Resource ID Value: numeric identifier (useful for resource tables / image lists).

You edit these fields in the Icon properties dialog (see below).

A common practice is to keep names predictable:

  • document-add, document-remove (overlay variants)

  • 001_open, 002_save (numbered lists for ordering)

Icon properties

Icon properties are the central place to edit per‑icon settings in a collection: name, IDs, overlay position, colorization, and background.

Open Icon Properties

  1. Select one or more icons in the collection.

  2. Right‑click the selection and choose Properties.

You can also use:

  • Edit ‣ Properties Alt+Enter

Collection Icon Properties dialog

Collection Icon Properties dialog.

Name

Sets the icon name stored in the collection. This name is typically used for organization and may be used as a base for filenames during export (depending on the selected export options and format).

Resource ID

Defines a symbolic identifier for the icon (example: ID_SAVE). This is useful when you reference exported icons from source code or when you generate resource files in a build process.

Resource ID Value

Defines a numeric identifier for the icon (example: 1000). This is often used in environments where icons are referenced by integer IDs.

Index Names & IDs

When enabled, IconGenerator automatically adds indexes to avoid duplicate Name and Resource ID values, especially in multi‑selection edits.

This is helpful when you apply the same base name/ID to several icons: the application keeps them unique by appending an index.

Overlay Position

Sets the overlay position for the selected icon(s) using the same four positions described in Adding Overlays. This is the per‑icon equivalent of the F5F8 commands.

Colorization

Enables and configures per‑icon colorization stored in the collection:

  • Icon checkbox + color swatch: apply a color to the base icon.

  • Overlay checkbox + color swatch: apply a color to the overlay (separately from the base icon).

Color selection uses the same palette system described in Colorizing icons.

Icon Background

Adds and configures a background behind the icon:

  • Show Background: enables the background.

  • Colorize Background: enables a custom background color, chosen with the color swatch.

Background options are useful when you want “tile” style icons or when you need a visible background for previews or exports.

Multiple selection behavior

When several icons are selected, the dialog shows an Information – Multiple Selection message. Any information entered above (when applicable) is applied to the entire selection. If Index Names & IDs is enabled, indexes are added to avoid identical names and IDs across the selection.

Collection context menu reference

Right‑click a selection of icons in a collection to open a context menu with the most common commands.

Export

  • Create Collection Icon Files… F4

Clipboard and editing

  • Cut

  • Copy

  • Paste

  • Delete

Selection

  • Select All

  • Select None

Sort

  • Sort → Ascending

  • Sort → Descending

Overlays

  • Overlay Position: Top‑Left F5

  • Overlay Position: Top‑Right F6

  • Overlay Position: Bottom‑Left F7

  • Overlay Position: Bottom‑Right F8

  • Remove Overlay

Quick copy / save

For fast one‑off reuse, the context menu provides commands to copy or save a single collection icon without running a full batch export.

  • Copy Large Image as * Vector SVG Code * Vector XAML Code * Bitmap at Scale 1:1 (native size) * Bitmap at Scale 2:1 (double size) * Bitmap at Scale 10:1 (high resolution)

  • Save Large Image as * Vector SVG * Vector XAML * Bitmap at Scale 1:1 (native size) * Bitmap at Scale 2:1 (double size) * Bitmap at Scale 10:1 (high resolution)

If the current icon set provides two native sizes (small + large), additional submenus are available:

  • Copy Small Image as

  • Save Small Image as

The menu displays the exact pixel dimensions based on the icon set definition.

Properties

  • Properties (opens the Collection Icon Properties dialog)

Generate icon files from a collection (batch export)

To generate a full set of files from your collection:

  • Collection ‣ Create Collection Icon Files… F4

This opens the same export options dialog described in Export formats and options. You can select vector formats, bitmap formats, sizes, and additional options (image strips, hot/disabled variants, colorization, dark mode generation, etc.).