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.

  • is:maindeck

    Show cards either units, events, or upgrades.

  • is:leader

    Show cards that have the card type Leader.

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 =.

  • power:>2 or hp:>2

    Show cards that have either Power greater than 2 or HP greater than 2.

  • aspect:a or aspect:vil cost:<=2

    Show cards that are either Aggression aspected, or cards that are Villainy aspected that cost less than or equal to 2 Resources.

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 (()).

  • (c:h or c:k) t:u

    Show Units with a morality Aspect.

  • (c:a ability:sentinel) or (aspect:Heroism a:restore)

    Show Aggression cards that mention Sentinel and Heroism cards that mention Restore.

Quotation Marks

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

  • title:"Aspiring to Authority"

    Search for cards with the title "Aspiring to Authority".

  • a:"have the initiative"

    Show cards whose ability text includes "have the initiative".

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.

  • a=sentinel

    Show cards that mention sentinel. (Keyword search is not yet implemented.)

  • ability:experience r:<3

    Show cards that mention experience that cost 2 or less.

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.

  • arena:s

    Show cards that are playable in space.

  • l=g

    Show ground cards.

Artist

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

  • art:Aboshady

    Show cards illustrated by an artist named Aboshady.

  • artist:Farrow

    Show cards illustrated by an artist named Farrow.

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).

  • c:g

    Show cards with the Command aspect.

  • aspect=Vigilance s:sor

    Show Vigilance-only cards in the Spark of Rebellion set.

  • c:h or c:b

    Show cards with either the Heroism or Vigilance aspects (or both).

  • c<=bw

    Show cards with either the Heroism or Vigilance aspects (or both).

  • c:rk

    Show cards with both the Aggression and Villainy aspects.

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.

  • r=1

    Show all cards with a cost of 1.

  • cost<=2 tr:trooper

    Show all Troopers that cost 2 or less.

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.

  • p>=3

    Show all cards with a power greater than or equal to 3.

  • health>2 a:r

    Show all Aggression cards with more than 2 HP.

Keywords

You can search for the existence of a keyword on a card using keyword or kw. Using the colon operator will include cards that could have the keyword, whereas using the equal sign operator will only return cards that unconditionally have the keyword.

Cards that grant keywords are not included - they do not have the keyword.

  • kw:sentinel

    Show all cards with Sentinel. Gamorrean Retainers would be included in this result.

  • keyword=sentinel

    Show all cards with Sentinel. Gamorrean Retainers would not be included in this result.

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
  • l:de

    Search for all German cards.

  • language!=English variant:Showcase

    Show all Showcases not in English.

Title

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

  • ti=Mentor

    Show all cards whose title mentions 'mentor'.

Rarity

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

  • rarity!=common

    Show all cards whose rarity is not Common.

  • rarity:s or rarity:r

    Show all cards whose rarity is Rare or Special.

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.

  • tr=Vehicle

    Show all vehicles.

  • trait:Imperial c:g

    Show all Imperial cards with the Command aspect.

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
  • t:Unit

    Show all Units.

  • t:a c:g

    Show all Command Upgrades.

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.

  • u:t t:a

    Show all Upgrades that are unique.

  • unique!=True

    Show all cards that are not unique.

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
  • v:op

    Show all variants with the organize play border.

  • variant!=base

    Show all variants that are not the base version.