Skip to content

Card database conventions

The Pokémon TCG has certain elements to it that are not clearly standardized. This document aims to resolve these issues by providing clear guidelines on how to structure and represent various kinds of data. Also see card database inconsistencies.

TCG region

The Pokémon TCG has different versions based on its geographic location. The available TCG regions are:

  • international
  • Japan

Expansion

Codes

An expansion code is a small piece of text that (not always uniquely) identifies an expansion. For the international TCG region, the expansion code is not often shown or referred to, but can be easily found on various Pokémon TCG sources. For the Japan TCG region, the expansion code is often shown as the expansion symbol. An expansion can have zero, one or many codes.

Card

Name

The card name is the text found at the top left of a card. It excludes any other information such as the Pokémon stage. The official Pokémon TCG checklists can be used as a reference. All cards have a name.

Number

The card number is the small piece text found at the bottom left or right of a card. It's used to identify a card within an expansion. Not all (but most) cards have a number. The card number must always include the right/denominator part (if available), e.g., 58/102. Card numbers don't always have a right part and can also be strictly text, e.g., ONE and AR7. The official Pokémon TCG checklists can be used as a reference.

The following text can be incorrectly assumed to be a card number, but is not:

For the Japan TCG Region:

  • BW-P
  • DAR
  • FAI
  • FIG
  • FIR
  • GRA
  • LIG
  • MET
  • PSY
  • S-P
  • SM-P
  • WAT
  • XY-P

Number sorting order

Because card numbers are not strictly integers and not all cards have a number, a separate integer number is required to determine the position of cards within the expansion list. This integer must be greater or equal to 1 and must be incremented by steps of 1. It can usually be deduced from the card number, e.g., 58 from 58/102.

Variants

A card with the same expansion and number (or number sorting order) often has different versions. These different versions are called variants. A card has at least one variant.

A variant has a type. This type is used as a label and it describes one or more types conceptually. Additionally, each card variant type can be a standard set or a parallel set type.

A list of card variant types that are used for at least 2 cards that also have a description can be found on the TCG Collector website. A full list of all available card variant types is to be added soon.

The current conventions regarding variants have several issues. More information about these issues and how they might be addressed can be found here.

Standard set

The standard set consists of variants that are shown as the first column on official checklists. However, not all expansions have an official checklist. Therefore, if one of the following criteria is true, an expansion is considered to have a standard set:

  • The expansion has an official checklist with a standard set column.
  • Most cards of the expansion have a number with a right part, e.g., /102.
  • The cards were released at the same time with the intention of being collected as a set. This means that promotional cards such as the Black Star Promos cannot have a standard set variant by definition.

Parallel set

The standard set often has a complementary set called the parallel set. This parallel set is shown as the second column on official checklists. However, not all expansions have an official checklist. Therefore, if one of the following criteria is true, an expansion is considered to have a parallel set:

  • The expansion has an official checklist with a parallel set column.
  • The expansion meets the criteria for having a standard set and all cards with a regular rarity (see 1*) have a variant that features a similar pattern (often reverse holographic).

1*: A regular rarity is defined as Common, Uncommon, Rare, Rare Holo, or any other rarity with an equivalent tier.

Type naming

  • A type must have a name that is visually descriptive. An exception to this rule is made for types that are conceptual in nature, e.g., Normal (standard set).
  • A type name cannot contain the , character. It's reserved for combining multiple types (see assigning variants § combining types).
  • When creating a variation of an existing type, "qualifier" braces must be used, e.g., Cosmos Holo (Missing HP) and Normal (Shadowless) (Red Cheeks). Each qualifier must have its own braces, saparated by a space character.

Assigning variants

Each variant must have a type that uniquely identifies it within the context of a card.

If the card has a standard set and/or a parallel set variant, these variants must be assigned first. Additional variants that visually differ from the standard set and parallel set variants can be assigned subsequently.

If a card has only one variant and that variant is neither a standard set or a parallel set variant, then the Promo card variant type can be used as a (temporary) placeholder. The Promo card variant type prevents you from having to do research on the visual characteristics of a variant, such as its holographic pattern.

If a standard set or parallel set variant has characteristics that deviate strongly from regular cards, then these characteristics must also be included in the card variant type name (see combining types). Jumbo sized cards are a primary example of this.

Combining types

Sometimes, a card has two or more variants that need to use the same type, but they differ in other characteristics such as the holographic pattern. In such cases, there are two options:

  1. If the other characteristics refer to existing card variant types, new card variant type(s) that combine multiple types must be created:

    • The , character must be used followed by a space to separate the card variant types, e.g., Darkness Ablaze Stamp, Jumbo Size.

    • The least amount of card variant types in order to uniquely identify the new type must be used. Otherwise the list will grow too long. An exception is made for characteristics that refer to holographic patterns (including non-holographic). All newly combined types must include it. For example, Yellow A Alternate, Non-holo and Yellow A Alternate, Sheen Holo is correct, but Yellow A Alternate and Yellow A Alternate, Sheen Holo is incorrect.

    • A standard set and/or parallel set card variant type must be listed before other types.

    • Card variant types describing a holographic pattern (including non-holographic) must be listed last, e.g., Jumbo Size, Sheen Holo.

  2. The other characteristics don't refer to existing card variant types. In such case, new card variant type(s) using "qualifier" braces must be created (see type naming).

Supertype

A card always has a supertype. It's not shown on the card itself, but it can be easily identified. The available card supertypes are:

  • Pokémon
  • Trainer
  • Energy

Types

Card types are more specific descriptions of card supertypes. They are not explicitly listed on cards, but can be deduced from various aspects. They are treated like tags, meaning that a card can have multiple types at once (optionally ordered by their importance). If no specific card types apply to Pokémon or Trainer cards, the generic Pokémon or Trainer card types must be used as a fallback. These card types cannot be combined with any other card types. For example, Pokémon and Ultra Beast is not allowed to be used together.

The stage of the Pokémon (e.g., Basic and Stage 1) is not considered a card type, because it specifically relates to the evolution status of the Pokémon. It's defined separately as Pokémon stage.

Some rarities imply a card type as well. Official examples are Rare Holo ex as Pokémon ex and Rare Holo V as Pokémon V. However, some rarities don't have an official card type, although it would make sense for them to have one. Examples are Rare Rainbow and Rare Shiny. Although not official, card types must be created for these rarities as well, because otherwise, it would make filtering on cards with the Promo rarity impossible.

A list of all available card types including both official and non-official ones can be found here.

Pokémon stage

The Pokémon stage can be found at the top left of a card. Usually only Pokémon cards have a stage. The available Pokémon stages are:

  • BREAK
  • Baby
  • Basic
  • LEGEND
  • LEVEL-UP
  • MEGA
  • Restored
  • Stage 1
  • Stage 2
  • V-UNION
  • VMAX
  • VSTAR

Evolves from

A card can be an evolution of another Pokémon or Trainer card. This information is usually found at the top left of a card. evolves from must include the full card name mentioned on the card; not just the name of the Pokémon.

Evolves into

evolves into can only be used for cards that explicitly mention it. This is usually the case for Pokémon cards with the Baby Pokémon stage. A Pokémon can evolve into one or more other Pokémon. evolves into must include the full card names mentioned on the card; not just the names of the Pokémon.

Energy types

Energy types are used for both Pokémon and Energy cards. For Pokémon cards, the energy type(s) of the Pokémon itself are used. For Energy cards, every energy provided is used. It doesn't take into account multiple energies of the same type.

The number of provided energies might differ for later reprints of certain Energy cards such as Rainbow Energy, because the Fairy energy type was introduced later on.

A Pokémon or Energy card has at least one energy type.

The available energy types and their codes are:

  • Grass (G)
  • Fire (R)
  • Water (W)
  • Lightning (L)
  • Psychic (P)
  • Fighting (F)
  • Darkness (D)
  • Metal (M)
  • Fairy (Y)
  • Dragon (N)
  • Colorless (C)

Rules

There are two kinds of card rules: official and generic rules. The official card rules are recognized for competitive play. The generic card rules can be anything that provides additional information, but doesn't fit the definition of a card description. No distinction must be made between the different types of card rules, but it's recommended to provide an additional "flag" whether a card rule is official or not.

Rules can be found anywhere on the card, including the yellow/gray border. Sometimes, a specific name for the rule might be shown on the card, e.g., VMAX rule. If so, chances are high this is an official rule.

A card can have zero, one, or many rules.

Effects

Abilities, Pokémon Powers, Ancient Traits, etc., are grouped together as card "effects". A card can have zero, one, or many effects. The available card effect types are:

  • Ability
  • Ancient Trait
  • Held Item
  • Poké-BODY
  • Poké-POWER
  • Pokémon Power

Weaknesses and resistances

Card weaknesses and resistances can usually be found at the bottom of Pokémon cards. They always have an (energy) type and a value. A card can have zero, one, or many weakness(es) and resistance(s). If no value is shown next to the weakness or resistance on the card, a value of ×2 is implied.

Retreat cost

The retreat cost can be found at the bottom of Pokémon cards next to the weaknesses and resistances. If the Pokémon has no retreat cost, 0 is implied. 0 cannot be used for Trainer and Energy cards.

Rarity

The card rarity can be deduced from the symbol found at the bottom left or right of a card (not to be confused with the expansion symbol). Not all cards have a rarity.

This list contains all available rarities as found on the official Pokémon TCG checklists.

Illustrators

The illustrator(s) can be found at the bottom of a card. A card can have zero, one or many illustrators.

Pokédex numbers

Pokédex numbers only apply to Pokémon cards. If the card name contains multiple Pokémon, the Pokédex number of each Pokémon must be used from left to right.

Format

The card format indicates the legality of a card regarding competitive play. All cards have a format. It's not shown on cards, but information can easily be found on official Pokémon TCG sources. The available card formats are:

  • Standard
  • Expanded
  • Unlimited
Back to top