Filter keywords help distribute galleries into groups. A gallery is assigned to a group if it matches the search query. The syntax uses spaces for AND, a vertical bar (|) for OR, parentheses for grouping, and minus (-) for negation. Here are some examples:

Both words must appear in the description (two conditions):

word1 word2

Either word1 or word2 should appear in the description (one condition):

word1|word2

Two conditions: word1 must be present, and either word2 or word3 must also be present. The phrase “word1 blah blah word4” won't match because it doesn't contain word2 or word3:

word1 (word2|word3)

word1 must be present, but word2 must not be:

word1 -word2

word1 must be present, but neither word2 nor word3 should be:

word1 -word2 -word3

Be careful with negation in grouped expressions. For example:

word1 (-word2|-word3)

This evaluates to “word1 AND (not word2 OR not word3)”. If you have the phrase “word1 word3”, the condition matches because word1 is present. In the parenthesized OR condition, since word2 is absent, the entire parenthetical condition succeeds without needing to check further.

By default, the script searches for partial word matches. To refine your search, use these modifiers:

Quotes ““ select consecutive words. For example, “word1 word2” matches word1 word2 zzzz but not word1 zzz word2, since the words must be adjacent.

^ (word start) anchors a match to the beginning of a word. By default, word matches both words and prewords because the script finds partial occurrences. Use ^word to match only when the word starts with those letters (matching word and words but not prewords).

$ (word end) anchors a match to the end of a word. By default, word matches both word and words. Use word$ to match only the exact form word, not words.

Common mistakes: (blue|green|light red) appears to offer three color choices, but the script interprets “light red” as two words, resulting in blue OR green OR light AND red. To fix this, use (blue|green|”light red”).

When importing filter keywords into the Categories field during import, the naming may not exactly match the category name in your database.

For example, if you have a category called “Vehicles” but the import data contains “Cars”, the filter keyword “car | bus” will still match it to the Vehicles category because the script searches in the category field itself (not in descriptions).

During import, galleries are added to a category if the tag name exactly matches the category name.

When using ImportSets, some galleries may be excluded from the database if they don't pass the word filtering criteria. To capture these filtered galleries, create a category (group) named exactly scj_unfiltered. All galleries that don't match any other group will be automatically added to this category. You can hide it from public display and periodically review it to identify new keywords to add.