Skip to content

Priority Tags Configuration Guide

pixelpaws edited this page Oct 11, 2025 · 4 revisions

This guide explains how to tailor the tag priority order that powers folder naming and tag suggestions in the LoRA Manager. You only need to edit the comma-separated list of entries shown in the Priority Tags field for each model type.

1. Pick the Model Type

In the Priority Tags dialog you will find one tab per model type (LoRA, Checkpoint, Embedding). Select the tab you want to update; changes on one tab do not affect the others.

2. Edit the Entry List

Inside the textarea you will see a line similar to:

character, concept, style(toon|toon_style)

This entire line is the entry list. Replace it with your own ordered list.

Entry Rules

Each entry is separated by a comma, in order from highest to lowest priority:

  • Canonical tag only: realistic
  • Canonical tag with aliases: character(char|chars)

Aliases live inside () and are separated with |. The canonical name is what appears in folder names and UI suggestions when any of the aliases are detected. Matching is case-insensitive.

Use {first_tag} in Path Templates

When your path template contains {first_tag}, the app picks a folder name based on your priority list and the model’s own tags:

  • It checks the priority list from top to bottom. If a canonical tag or any of its aliases appear in the model tags, that canonical name becomes the folder name.
  • If no priority tags are found but the model has tags, the very first model tag is used.
  • If the model has no tags at all, the folder falls back to no tags.

Example

With a template like /{model_type}/{first_tag} and the priority entry list character(char|chars), style(anime|toon):

Model Tags Folder Name Why
["chars", "female"] character chars matches the character alias, so the canonical wins.
["anime", "portrait"] style anime hits the style entry, so its canonical label is used.
["portrait", "bw"] portrait No priority match, so the first model tag is used.
[] no tags Nothing to match, so the fallback is applied.

3. Save the Settings

After editing the entry list, press Enter to save. Use Shift+Enter whenever you need a new line. Clicking outside the field also saves automatically. A success toast confirms the update.

Examples

Goal Entry List
Prefer people over styles character, portraits, style(anime|toon)
Group sci-fi variants sci-fi(scifi|science_fiction), cyberpunk(cyber|punk)
Alias shorthand tags realistic(real|realisim), photorealistic(photo_real)

Tips

  • Keep canonical names short and meaningful—they become folder names.
  • Place the most important categories first; the first match wins.
  • Avoid duplicate canonical names within the same list; only the first instance is used.

Troubleshooting

  • Unexpected folder name? Check that the canonical name you want is placed before other matches.
  • Alias not working? Ensure the alias is inside parentheses and separated with |, e.g. character(char|chars).
  • Validation error? Look for missing parentheses or stray commas. Each entry must follow the canonical(alias|alias) pattern or just canonical.

With these basics you can quickly adapt Priority Tags to match your library’s organization style.

Clone this wiki locally