Search Syntax

Syntactic Sugar

SWUDB includes the syntactic sugar keywords is and isnot for ease of use and readability during sharing of queries. Both are parsed as more specific queries, as listed below.

• maindeck: Does the card go in your maindeck?
• special, common, uncommon, rare, or legendary: Each is parsed as rarity: or rarity!= respectively.
• unit, event, upgrade, leader, base, or token: Each is parsed as rarity: or rarity!= respectively.
• vanilla: A card is "vanilla" if it has no ability text.
• mine: A card is yours if it is in your collection.

Boolean Logic

By default, each space-delimited portion of a query is a necessary quality of a card. For example, the search query aspect:a cost=2 will only match cards that are both Aggression aspect cards and have a resource cost of 2.

You can use the query term or to join multiple queries. Any card that meets either the left or right conditions will be returned. Multiple or statements are not nested - each or creates a new collection of queries against which a card might qualify for inclusion in the results.

You can use a variety of comparison operators: :, =, =, !=, <, <=, >, and >=. Generally text fields won't accept anything except : or =.

Parenthesis

You can join queries together using parentheses (). The text inside the parentheses will be evaluated before the rest of the query, and then treated as its own query.

SWUDB does not currently support nested parentheses (()).

Quotation Marks

You can use quotation marks - " - to look for phrases within bodies of text.

Ability

You can search cards by their ability text using a or ability. This will search the ability text of both sides of a card for Leaders.

SWUDB does not currently have keyword search. Searches will not search helper text.

Arena

You can search for a card by its playable arena - space or ground - with arena, l, or lane. Arenas can be referred to by s/space or g/ground.

Artist

You can search for any card by artist, using artist.

Aspect

You can search for any card by its aspect or color, using c, color, or aspect. You can refer to aspects by their name or their color.

Aspects can be referred to by their full name, like heroism, or by the minimally distinctive letters of their name: a, co, cu, h, vig, or vil.

Aspects can also be referred to by their color, using the full color name like black, or using a singular letter for the color. The single letter color codes are r, g, w, y, b (Blue, for Vigilance), and k (blacK, for Villainy). When referring to aspects by a single-letter color, multiple aspects can be combined into one query (e.g., c:yw to get all cards with both Cunning and Heroism).

Searching for an aspect with : or >= will search for all cards that include the aspects. Searching with = will search for cards that are exactly those aspects. Searching for aspects with <= will find cards that contain some (or all) of the listed aspects, but no others (useful for finding cards that might go in your deck). (Other mathematical search parameters coming soon.)

Searching for more than one color in one parameter requires using single letter searching (e.g., a or r or u but not vig).

Cost

You can search for any card by its Resource cost, using r, resources, or cost.

Cost searching supports the mathematical comparisons =, !=, <, <=, >, and >=. It treats : as =.

Note that using != or <> will not catch cards with no cost; only cards with a cost are returned.

Hit Points and Power

You can search for any card by its Hit Point or Power value, using p, pow, or power (for Power), and hp, hitpoints, or health (for HP).

Hit Point and Power searching supports the mathematical comparisons =, !=, <, <=, >, and >=. It treats : as =.

Note that using != or <> will not catch cards with no Hit Point or Power value; only cards with a respective value are returned.

Language

You can search for any variant by its language, using lang or language, using comparisons :, =, and !=.

You can search using the following spellings:

• en or English
• de or German
• es or Spanish
• fr or French
• it or Italian

Title

If a card has a title, you can search for it using ti or title.

Rarity

You can search for a card's rarity with rarity.

Traits

You can search for any card by its traits, using tr, trait, or traits. Cards will match if any of their traits contain (or equal) the entered query.

Type

You can search for any card by its type, using t or type. Cards will match the following types:

• leader or l
• base or b
• unit or u
• event or e
• upgrade or a (for "attachment")
• token or t

Uniqueness

You can search for any card by whether or not it's unique, using u or unique. Only true, True, t, or T will match for truth, everything else is parsed as false.

Variants

You can search for a variant by its type of variant, using v or variant and the following criteria:

• normal or n
• hyperspace or h
• showcase or s
• organizedplay or op