Currently, all card articles depicting cards which were added in Patch 21.4.0.95431 or later use {{Card template v2}} to display the layout of the article.

Every single card MUST have a dbfId. For collectible cards, you can easily check its ID by looking at the links on PlayHearthstone Card Library or the Blizzard API. For example, https://playhearthstone.com/en-us/cards/66876-rokara-the-valorous means Rokara, the Valorous's dbfId is 66876.

Usage

{{Card template v2
 |dbfId=

// Derived keys: Keys that have default value based on the official data we get. You can edit these key values, but it's suggested that you keep them as their default value.

 |derived_img=
 |derived_imgMain=
 |derived_imgMainPremium=
 |derived_imgBg=
 |derived_imgBgPremium=
 |derived_imgMercTemplate=
 |derived_imgMercAbility=
 |derived_imgMercPortrait=
 |derived_imgArt=
 |derived_imgFullArt=
 |derived_imgSignatureFullArt=
 |derived_artist=
 |derived_classIds=
 |derived_classOrder=
 |derived_coreUnlockedLevel=
 |derived_exclusions=
 |derived_faction=
 |derived_formats=
 |derived_goldenUncraftable=
 |derived_isRemoved=
 |derived_regularUncraftable=
 |derived_relatedCardDbfIds=
 |derived_choiceCardDbfIds=
 |derived_setId=
 |derived_text=
 |derived_trimText=
 |derived_lastAdded=
 |derived_lastModified=
 |derived_minionTypeIds=
 |derived_minionTypeStrings=

// Custom keys: Made-up keys that are non-existent or unrelated to official data, but prove to be useful. You can edit these keys freely without being afraid of disrupting official data.

 |custom_advPools=
 |custom_advHeroPowerDbfIds=
 |custom_advSignatureDbfIds=
 |custom_artistReferences=
 |custom_bannedOfferDbfIds=
 |custom_bgPage=
 |custom_bgSoundId=
 |custom_characs=
 |custom_characsInArt=
 |custom_coreInYears=
 |custom_cycles=
 |custom_externalLinks
 |custom_genders=
 |custom_hearthpwnId=
 |custom_hiddenTags=
 |custom_mechanicTags=
 |custom_onBlizzardApi=
 |custom_originalCardDbfId=
 |custom_outOfCardsId=
 |custom_races=
 |custom_racesInArt=
 |custom_refTags=
 |custom_voiceActor=
 |custom_voiceActorReferences=

 // Article sections: These keys generate sections in the article itself, such as Notes, History, or Lore

 |article_description=
 |article_relatedCards=
 |article_relatedWith=
 |article_notes=
 |article_achievements=
 |article_sounds=
 |article_soundsCUSTOM_trigger=
 |article_soundsCUSTOM_other=
 |article_soundsCUSTOM_triggerReferences=
 |article_soundsCUSTOM_otherReferences=
 |article_history=
 |article_lore=
 |article_trivia
 |article_gallery=
 |article_videos=
 |article_meta=
 |article_addedCategories=
}}

Custom fields

These fields are not directly stored in game data and must be declared manually for querying.

Overriding properties

derived_artist

• Overrides the artist value. Most of uncollectible cards do not define this property.

Text fields

custom_bgPage

• The page name of the Battlegrounds version of the minion card. It is not used for any other card types like spell.
• There are cards that are used in both Constructed and Battlegrounds, like Murloc Tidehunter. In that case, you can set the field to |custom_bgPage=Battlegrounds/Murloc Tidehunter
• There are cards that have different entities (different dbfIds). For example, Ghastcoiler has dbfId=52041 and is used in Rumble Run. However, it is not used in Battlegrounds, because there is another Ghastcoiler which has dbfId=59687 and is used in Battlegrounds due to different summoning pools. In this case, custom_bgPage does not need to be declared. Similar cases include Micro Machine & Battlegrounds/Micro Machine and any minions that summon other minions.

custom_voiceActor

• The name of the voice actor who voices this card. Works similarly to derived_artist.
• Example: |custom_voiceActor=Chris Metzen

Image fields

General notes

• Any reserved characters should be replaced with -.

derived_imgMain

• Base name for the image or regular version of card image to display when queries use the image layouts. File type is not needed.
• Example: RLK_060 LT_001

derived_imgMainPremium

• Base name for the golden version of card image to display when queries use the image layouts.
• File type is not needed.
• Do not use this for Mercenaries cards.
• Example: RLK_060_Premium1

derived_imgBg

• Base name for the Battlegrounds version of card image to display when queries use the image layouts.
• File type is not needed.
• Example: BG_DAL_077_Battlegrounds

derived_imgFullArt

• Full filename of the card's full art.
• Example: Cariel Roame full.jpg
• Notes: In the file pages, you must use {{Card artwork}}, credits the artist's names and leave the sources where you find the files.

List text fields

These fields store a list of texts which are separated by &&.

derived_exclusions

• Rules that exclude this card from where it would be normally applied.
• Available exclusions: Arena, Duels deck-building, Duels card buckets, Wild, Tavern Brawl <name of Tavern Brawl>, Card generation

custom_cycles

• Card cycles or pools that this card belongs to. For example, SI:7 Agent belongs to SI:7.
• Available cycles can be found in Template:Cycles table.

custom_mechanicTags

• Abilities (keywords and mechanics) on cards, such as Taunt or Charge.

custom_refTags

• Card text that references abilities, but doesn't have them on the card itself. For example, Taunt-generating, Rush-granting, or Stealth-related.

custom_hiddenTags

• Certain mechanics or tags that don't need to be visible on the infobox, such as triggered effect specifications, e.g. Triggered effect - after this attacks and kills a minion

custom_races

• The race(s) that the card (usually minion) is. See Template:Card art for current available races.
• Example: Night elf

custom_racesInArt

• Races in the background of the card art, or races that are referenced by the card art.

custom_characs

• Named character that the card (usually minion) is.
• Example: Medivh

custom_characsInArt

• Characters in the background of the card art, or characters that are referenced by the card art.

custom_genders

• The gender of the card. Values are 0, 1, or 2, for female, male, and other.

Querying fields

General notes

• These fields are dbfIds of the cards or IDs of any other entities. If it's a list, they must be separated by &&.
• For example: 10000&&20000&&30000

derived_relatedCardDbfIds

• Cards that are related to this card or mentioned in this card's text.
• Example: Animal Companion has Huffer

derived_choiceCardDbfIds

• Cards that are used as choices when this card is used.
• Example: Living Roots has Grasping Roots

custom_originalCardDbfId

• DbfId of the original version of this card.

Article fields

These fields present the format of the article and sections.

Text fields

article_custom

• This is where you can customize the layout of the card article in any way you wish if the layout does not satisfy you. Using article_custom=true allows the article to have an entirely custom layout. Otherwise, it will use the default layout.
• This however does not hide the infoboxes.

article_description

• The first paragraph of the article, before the first section.

article_relatedCards

• Used to display a custom layout for a card's related cards. By default, the related cards will simply be listed from derived_relatedCardDbfIds.

article_relatedWith

• Used to display a custom layout for cards this card is related with. By default, the cards it's related with will simply be listed from other cards that have this card in their derived_relatedCardDbfIds section.

article_notes

• Notable or unusual interactions between this card and other cards or game mechanics. Separated by &&.

article_sounds

• By default, this will list the card's play, attack, and death sounds. If not left empty, a custom Sounds section layout can be written here.

article_soundsCUSTOM_trigger

article_soundsCUSTOM_other

• List of sound filenames that you wish to add if the generated data are not enough. Separated by ,.
• Example: LET_001_Human.wav, LET_002_Human.wav

article_soundsTRANSCRIPT_play

article_soundsTRANSCRIPT_trigger

article_soundsTRANSCRIPT_attack

article_soundsTRANSCRIPT_death

article_soundsTRANSCRIPT_other

• List of strings that transcribe the sounds from top to bottom. Separated by ,.
• If there are any transcript you wish to include comma, use &#44*; (without *) entity.
• Example: Careful&#44*; they bite., I bite too! (without *)
• These transcripts will first be reviewed by admins, then they will be added to a data table, from which they will automatically appear on the card article.

article_achievements (no longer recommended from 2023, since Achievements can be handled with Template:CustomAchievement table.)

• Uses {{Achievement query}} to get the achievements that are directly related to this card.

article_history

• History of other sections, in case of a massive change or redesign like Mindrender Illucia once received.

article_lore

• Lore of the card.

article_trivia

• Trivia of the card, such as fun facts or information not related to Hearthstone specifically.

article_gallery

• List of images that are related to this card art or gameplay.
• Example:
  Northshire Cleric sketch.jpg{{!}}Sketch art
<full filename>{{!}}<caption of the image>

article_videos

• List of videos that are related to this card.
• Example:{{#ev:youtube|kQS0bUrZhCA|350|inline}}

Wiki style guides By page section General By page category Cards Tags Mercenaries bounty encounters