Layouts and Faces

The layout column categorizes the arrangement of card parts, faces, and other bounded regions on cards. The layout can be used to programmatically determine which other properties on a card you can expect.

Specifically:

  • Cards with the layouts split, flip, transform, and double_faced_token will always have a card_faces column describing the distinct faces.
  • Cards with the layout meld will always have a all_parts column pointing to the other meld parts.
Layout Description
normal A standard Magic card with one face
split A split-faced card
flip Cards that invert vertically with the flip keyword
transform Double-sided cards that transform
modal_dfc Double-sided cards that can be played either-side
meld Cards with meld parts printed on the back
leveler Cards with Level Up
class Class-type enchantment cards
saga Saga-type cards
adventure Cards with an Adventure spell part
planar Plane and Phenomenon-type cards
scheme Scheme-type cards
vanguard Vanguard-type cards
token Token cards
double_faced_token Tokens with another token printed on the back
emblem Emblem cards
augment Cards with Augment
host Host-type cards
art_series Art Series collectable double-faced cards
reversible_card A Magic card with two sides that are unrelated

Card Faces

Magic cards can include multiple faces on a single piece of card stock. Scryfall includes information about each of these card faces using the card_faces column. Please note the following types of multi-face cards and how Scryfall will describe them:

Split cards (Comp. rules term): Split cards are sorceries or instant cards that include two faces and the caster can choose which face to cast. The back of a split card is the normal Magic back.

glimpse(scry_card("0f279560-7e9f-4a6d-9fd6-6c8c6bd94a1b"))
#> Rows: 1
#> Columns: 58
#> $ id                <chr> "0f279560-7e9f-4a6d-9fd6-6c8c6bd94a1b"
#> $ name              <chr> "Wear // Tear"
#> $ set               <chr> "cmr"
#> $ lang              <chr> "en"
#> $ colors            <list> <"R", "W">
#> $ color_identity    <list> <"R", "W">
#> $ mana_cost         <chr> "{1}{R} // {W}"
#> $ cmc               <dbl> 3
#> $ type_line         <chr> "Instant // Instant"
#> $ edhrec_rank       <int> 776
#> $ keywords          <list> "Fuse"
#> $ layout            <chr> "split"
#> $ legalities        <list> [<tbl_df[1 x 22]>]
#> $ oversized         <lgl> FALSE
#> $ reserved          <lgl> FALSE
#> $ oracle_id         <chr> "9842734c-1eac-4509-a731-4c22017ae586"
#> $ mtgo_id           <int> 85730
#> $ multiverse_ids    <list> 500936
#> $ tcgplayer_id      <int> 227383
#> $ cardmarket_id     <int> 514789
#> $ uri               <chr> "https://api.scryfall.com/cards/0f279560-7e9…
#> $ scryfall_uri      <chr> "https://scryfall.com/card/cmr/456/wear-tear…
#> $ rulings_uri       <chr> "https://api.scryfall.com/cards/0f279560-7e9…
#> $ prints_search_uri <chr> "https://api.scryfall.com/cards/search?order…
#> $ card_faces        <list> [<tbl_df[2 x 7]>]
#> $ artist            <chr> "Ryan Pancoast"
#> $ artist_ids        <list> "89cc9475-dda2-4d13-bf88-54b92867a25c"
#> $ booster           <lgl> FALSE
#> $ border_color      <chr> "black"
#> $ card_back_id      <chr> "0aeebaf5-8c7d-4636-9e82-8c27447861f7"
#> $ collector_number  <chr> "456"
#> $ digital           <lgl> FALSE
#> $ foil              <lgl> FALSE
#> $ nonfoil           <lgl> TRUE
#> $ finishes          <list> "nonfoil"
#> $ frame             <chr> "2015"
#> $ full_art          <lgl> FALSE
#> $ games             <list> <"paper", "mtgo">
#> $ highres_image     <lgl> TRUE
#> $ illustration_id   <chr> "35dc8f1e-5c26-4f3f-98eb-62123968a04f"
#> $ image_status      <chr> "highres_scan"
#> $ image_uris        <list> [<tbl_df[1 x 6]>]
#> $ prices            <list> [<tbl_df[1 x 3]>]
#> $ promo             <lgl> FALSE
#> $ purchase_uris     <list> [<tbl_df[1 x 3]>]
#> $ rarity            <chr> "uncommon"
#> $ related_uris      <list> [<tbl_df[1 x 4]>]
#> $ released_at       <date> 2020-11-20
#> $ reprint           <lgl> TRUE
#> $ scryfall_set_uri  <chr> "https://scryfall.com/sets/cmr?utm_source=a…
#> $ set_name          <chr> "Commander Legends"
#> $ set_search_uri    <chr> "https://api.scryfall.com/cards/search?orde…
#> $ set_type          <chr> "draft_innovation"
#> $ set_uri           <chr> "https://api.scryfall.com/sets/39de6fbf-1f11…
#> $ set_id            <chr> "39de6fbf-1f11-48d0-8f04-f0407f6a0732"
#> $ story_spotlight   <lgl> FALSE
#> $ textless          <lgl> FALSE
#> $ variation         <lgl> FALSE

Flip cards (Comp. rules term): Flip cards have two parts of a permanent printed vertically on one side of the card. During play, an ability on the card causes the permanent to flip (rotate 180°) to the other side. The back of a flip card is the normal Magic back.

glimpse(scry_card("0b61d772-2d8b-4acf-9dd2-b2e8b03538c8"))
#> Rows: 1
#> Columns: 60
#> $ id                <chr> "0b61d772-2d8b-4acf-9dd2-b2e8b03538c8"
#> $ name              <chr> "Erayo, Soratami Ascendant // Erayo's Essenc…
#> $ set               <chr> "sok"
#> $ lang              <chr> "en"
#> $ colors            <list> "U"
#> $ color_identity    <list> "U"
#> $ mana_cost         <chr> "{1}{U}"
#> $ cmc               <dbl> 2
#> $ power             <chr> "1"
#> $ toughness         <chr> "1"
#> $ type_line         <chr> "Legendary Creature — Moonfolk Monk // Legen…
#> $ keywords          <list> "Flying"
#> $ layout            <chr> "flip"
#> $ legalities        <list> [<tbl_df[1 x 22]>]
#> $ oversized         <lgl> FALSE
#> $ reserved          <lgl> FALSE
#> $ oracle_id         <chr> "d83bb32d-f409-421a-9d93-bd7ea3240b47"
#> $ mtgo_id           <int> 22176
#> $ mtgo_foil_id      <int> 22177
#> $ multiverse_ids    <list> 87599
#> $ tcgplayer_id      <int> 12430
#> $ cardmarket_id     <int> 12658
#> $ uri               <chr> "https://api.scryfall.com/cards/0b61d772-2d8…
#> $ scryfall_uri      <chr> "https://scryfall.com/card/sok/35/erayo-sora…
#> $ rulings_uri       <chr> "https://api.scryfall.com/cards/0b61d772-2d…
#> $ prints_search_uri <chr> "https://api.scryfall.com/cards/search?orde…
#> $ card_faces        <list> [<tbl_df[2 x 9]>]
#> $ artist            <chr> "Matt Cavotta"
#> $ artist_ids        <list> "2e6a0611-9411-4ba4-98e3-c0e18cbf9f83"
#> $ booster           <lgl> TRUE
#> $ border_color      <chr> "black"
#> $ card_back_id      <chr> "0aeebaf5-8c7d-4636-9e82-8c27447861f7"
#> $ collector_number  <chr> "35"
#> $ digital           <lgl> FALSE
#> $ foil              <lgl> TRUE
#> $ nonfoil           <lgl> TRUE
#> $ finishes          <list> <"nonfoil", "foil">
#> $ frame             <chr> "2003"
#> $ full_art          <lgl> FALSE
#> $ games             <list> <"paper", "mtgo">
#> $ highres_image     <lgl> TRUE
#> $ illustration_id   <chr> "99cab97a-9861-4a5a-8578-6c742d192183"
#> $ image_status      <chr> "highres_scan"
#> $ image_uris        <list> [<tbl_df[1 x 6]>]
#> $ prices            <list> [<tbl_df[1 x 5]>]
#> $ promo             <lgl> FALSE
#> $ purchase_uris     <list> [<tbl_df[1 x 3]>]
#> $ rarity            <chr> "rare"
#> $ related_uris      <list> [<tbl_df[1 x 4]>]
#> $ released_at       <date> 2005-06-03
#> $ reprint           <lgl> FALSE
#> $ scryfall_set_uri  <chr> "https://scryfall.com/sets/sok?utm_source=ap…
#> $ set_name          <chr> "Saviors of Kamigawa"
#> $ set_search_uri    <chr> "https://api.scryfall.com/cards/search?order…
#> $ set_type          <chr> "expansion"
#> $ set_uri           <chr> "https://api.scryfall.com/sets/4db16ad3-2b95…
#> $ set_id            <chr> "4db16ad3-2b95-442f-bb6b-e9aa7fe7f769"
#> $ story_spotlight   <lgl> FALSE
#> $ textless          <lgl> FALSE
#> $ variation         <lgl> FALSE

Double-faced cards (Comp. rules term): These cards have two faces on different sides of the cardstock that are related to each other. The whole card is a single legal or deckbuilding object. Double-faced cards can either be transforming or modal.

Transforming double-faced cards (Comp. rules term): These cards can either transform after entering the battlefield, or can be put onto the battlefield already transformed. Scryfall will use the card_faces column to describe the two different transformed modes of the card. These cards have their layout set to “transform”.

glimpse(scry_card("b37aa12c-a6b3-4cf8-b5a4-0a999ff12d02"))
#> Rows: 1
#> Columns: 57
#> $ id                <chr> "b37aa12c-a6b3-4cf8-b5a4-0a999ff12d02"
#> $ name              <chr> "Arlinn Kord // Arlinn, Embraced by the Moon"
#> $ set               <chr> "soi"
#> $ lang              <chr> "en"
#> $ color_identity    <list> <"G", "R">
#> $ cmc               <dbl> 4
#> $ type_line         <chr> "Legendary Planeswalker — Arlinn // Legendar…
#> $ edhrec_rank       <int> 6705
#> $ keywords          <list> "Transform"
#> $ layout            <chr> "transform"
#> $ legalities        <list> [<tbl_df[1 x 22]>]
#> $ oversized         <lgl> FALSE
#> $ reserved          <lgl> FALSE
#> $ oracle_id         <chr> "6bb7d0df-7a9f-4e17-8c31-7628c4b12356"
#> $ mtgo_id           <int> 59762
#> $ mtgo_foil_id      <int> 59763
#> $ multiverse_ids    <list> <410007, 410008>
#> $ tcgplayer_id      <int> 115432
#> $ cardmarket_id     <int> 288952
#> $ uri               <chr> "https://api.scryfall.com/cards/b37aa12c-a6b…
#> $ scryfall_uri      <chr> "https://scryfall.com/card/soi/243/arlinn-ko…
#> $ rulings_uri       <chr> "https://api.scryfall.com/cards/b37aa12c-a6b…
#> $ prints_search_uri <chr> "https://api.scryfall.com/cards/search?orde…
#> $ all_parts         <list> [<tbl_df[4 x 6]>]
#> $ card_faces        <list> [<tbl_df[2 x 11]>]
#> $ artist            <chr> "Winona Nelson"
#> $ artist_ids        <list> "e45fe8d3-75d6-42c9-a2df-e945ad81ea27"
#> $ booster           <lgl> TRUE
#> $ border_color      <chr> "black"
#> $ collector_number  <chr> "243"
#> $ digital           <lgl> FALSE
#> $ foil              <lgl> TRUE
#> $ nonfoil           <lgl> TRUE
#> $ finishes          <list> <"nonfoil", "foil">
#> $ frame_effects     <list> "sunmoondfc"
#> $ frame             <chr> "2015"
#> $ full_art          <lgl> FALSE
#> $ games             <list> <"paper", "mtgo">
#> $ highres_image     <lgl> TRUE
#> $ image_status      <chr> "highres_scan"
#> $ prices            <list> [<tbl_df[1 x 5]>]
#> $ promo             <lgl> FALSE
#> $ purchase_uris     <list> [<tbl_df[1 x 3]>]
#> $ rarity            <chr> "mythic"
#> $ related_uris      <list> [<tbl_df[1 x 4]>]
#> $ released_at       <date> 2016-04-08
#> $ reprint           <lgl> FALSE
#> $ scryfall_set_uri  <chr> "https://scryfall.com/sets/soi?utm_source=ap…
#> $ set_name          <chr> "Shadows over Innistrad"
#> $ set_search_uri    <chr> "https://api.scryfall.com/cards/search?order…
#> $ set_type          <chr> "expansion"
#> $ set_uri           <chr> "https://api.scryfall.com/sets/5e914d7e-c1e9…
#> $ set_id            <chr> "5e914d7e-c1e9-446c-a33d-d093c02b2743"
#> $ story_spotlight   <lgl> FALSE
#> $ textless          <lgl> FALSE
#> $ variation         <lgl> FALSE
#> $ security_stamp    <chr> "oval"

Modal double-faced cards (Comp. rules term): Modal DFCs may be cast or played as either half of the card. Scryfall will use the card_faces column to describe the two different modes of the card. These cards have their layout set to “modal_dfc”.

glimpse(scry_card("ba09360a-067e-48a5-bdc5-a19fd066a785"))
#> Rows: 1
#> Columns: 58
#> $ id                <chr> "ba09360a-067e-48a5-bdc5-a19fd066a785"
#> $ name              <chr> "Extus, Oriq Overlord // Awaken the Blood Av…
#> $ set               <chr> "stx"
#> $ lang              <chr> "en"
#> $ color_identity    <list> <"B", "R", "W">
#> $ cmc               <dbl> 4
#> $ type_line         <chr> "Legendary Creature — Human Warlock // Sorce…
#> $ edhrec_rank       <int> 9029
#> $ keywords          <list> <"Magecraft", "Double strike">
#> $ layout            <chr> "modal_dfc"
#> $ legalities        <list> [<tbl_df[1 x 22]>]
#> $ oversized         <lgl> FALSE
#> $ reserved          <lgl> FALSE
#> $ oracle_id         <chr> "0b299983-9f0f-404a-acd1-8f142572b1f1"
#> $ arena_id          <int> 76544
#> $ mtgo_id           <int> 88779
#> $ multiverse_ids    <list> <516912, 516913>
#> $ tcgplayer_id      <int> 235673
#> $ cardmarket_id     <int> 557492
#> $ uri               <chr> "https://api.scryfall.com/cards/ba09360a-067…
#> $ scryfall_uri      <chr> "https://scryfall.com/card/stx/149/extus-ori…
#> $ rulings_uri       <chr> "https://api.scryfall.com/cards/ba09360a-06…
#> $ prints_search_uri <chr> "https://api.scryfall.com/cards/search?order…
#> $ all_parts         <list> [<tbl_df[2 x 6]>]
#> $ card_faces        <list> [<tbl_df[2 x 12]>]
#> $ artist            <chr> "Chase Stone & Kekai Kotaki"
#> $ artist_ids        <list> <"2d753f61-5f5b-468e-97ea-8e0fdd347340", "4b…
#> $ booster           <lgl> TRUE
#> $ border_color      <chr> "black"
#> $ collector_number  <chr> "149"
#> $ digital           <lgl> FALSE
#> $ foil              <lgl> TRUE
#> $ nonfoil           <lgl> TRUE
#> $ finishes          <list> <"nonfoil", "foil">
#> $ frame_effects     <list> "legendary"
#> $ frame             <chr> "2015"
#> $ full_art          <lgl> FALSE
#> $ games             <list> <"arena", "paper", "mtgo">
#> $ highres_image     <lgl> TRUE
#> $ image_status      <chr> "highres_scan"
#> $ preview           <list> [<tbl_df[1 x 3]>]
#> $ prices            <list> [<tbl_df[1 x 5]>]
#> $ promo             <lgl> FALSE
#> $ purchase_uris     <list> [<tbl_df[1 x 3]>]
#> $ rarity            <chr> "mythic"
#> $ related_uris      <list> [<tbl_df[1 x 4]>]
#> $ released_at       <date> 2021-04-23
#> $ reprint           <lgl> FALSE
#> $ scryfall_set_uri  <chr> "https://scryfall.com/sets/stx?utm_source=ap…
#> $ set_name          <chr> "Strixhaven: School of Mages"
#> $ set_search_uri    <chr> "https://api.scryfall.com/cards/search?orde…
#> $ set_type          <chr> "expansion"
#> $ set_uri           <chr> "https://api.scryfall.com/sets/541c3c28-8747…
#> $ set_id            <chr> "541c3c28-8747-40e5-a231-8e8f33234859"
#> $ story_spotlight   <lgl> TRUE
#> $ textless          <lgl> FALSE
#> $ variation         <lgl> FALSE
#> $ security_stamp    <chr> "oval"

Reversible cards (casual term): This term is used by both Scryfall and WotC to describe a piece of cardstock with two distinct Magic cards or tokens printed on opposite sides. The two halves of the card are not related to each other in any way and are treated as two separate objects for gameplay or deckbuilding. The overall card will have its layout set to “reversible_card”, while the individual card_face objects will have their own layout columns describing the distinct printings on both sides.

glimpse(scry_card("3e3f0bcd-0796-494d-bf51-94b33c1671e9"))
#> Rows: 1
#> Columns: 50
#> $ id                <chr> "3e3f0bcd-0796-494d-bf51-94b33c1671e9"
#> $ name              <chr> "Propaganda // Propaganda"
#> $ set               <chr> "sld"
#> $ lang              <chr> "en"
#> $ color_identity    <list> "U"
#> $ edhrec_rank       <int> 161
#> $ keywords          <list> <NULL>
#> $ layout            <chr> "reversible_card"
#> $ legalities        <list> [<tbl_df[1 x 22]>]
#> $ oversized         <lgl> FALSE
#> $ reserved          <lgl> FALSE
#> $ multiverse_ids    <list> <NULL>
#> $ tcgplayer_id      <int> 259214
#> $ uri               <chr> "https://api.scryfall.com/cards/3e3f0bcd-079…
#> $ scryfall_uri      <chr> "https://scryfall.com/card/sld/381/propagand…
#> $ rulings_uri       <chr> "https://api.scryfall.com/cards/3e3f0bcd-079…
#> $ prints_search_uri <chr> "https://api.scryfall.com/cards/search?order…
#> $ card_faces        <list> [<tbl_df[2 x 13]>]
#> $ artist            <chr> "Scott Balmer"
#> $ artist_ids        <list> "c26dd9c9-54f9-4a8c-9d54-caac6be0161d"
#> $ booster           <lgl> FALSE
#> $ border_color      <chr> "borderless"
#> $ collector_number  <chr> "381"
#> $ digital           <lgl> FALSE
#> $ foil              <lgl> TRUE
#> $ nonfoil           <lgl> FALSE
#> $ finishes          <list> "foil"
#> $ frame_effects     <list> "inverted"
#> $ frame             <chr> "2015"
#> $ full_art          <lgl> FALSE
#> $ games             <list> "paper"
#> $ highres_image     <lgl> TRUE
#> $ image_status      <chr> "highres_scan"
#> $ prices            <list> [<tbl_df[1 x 1]>]
#> $ promo             <lgl> FALSE
#> $ purchase_uris     <list> [<tbl_df[1 x 3]>]
#> $ rarity            <chr> "rare"
#> $ related_uris      <list> [<tbl_df[1 x 3]>]
#> $ released_at       <date> 2022-04-22
#> $ reprint           <lgl> TRUE
#> $ scryfall_set_uri  <chr> "https://scryfall.com/sets/sld?utm_source=a…
#> $ set_name          <chr> "Secret Lair Drop"
#> $ set_search_uri    <chr> "https://api.scryfall.com/cards/search?order…
#> $ set_type          <chr> "box"
#> $ set_uri           <chr> "https://api.scryfall.com/sets/4d92a8a7-ccb…
#> $ set_id            <chr> "4d92a8a7-ccb0-437d-abdc-9d70fc5ed672"
#> $ story_spotlight   <lgl> FALSE
#> $ textless          <lgl> FALSE
#> $ variation         <lgl> FALSE
#> $ security_stamp    <chr> "oval"

Multi-faced cards (casual term): This term has no rules meaning and is used by Scryfall to describe any object with the nested card_faces property.

Double-sided cards (casual term): This term has no rules meaning and is used only casually to refer to any cards with gameplay information on both sides.