Creator Code Support us with creator code RoyaleAPI

Deck Builder - New Feature

August 7, 2021 · 8 min read

Build Clash Royale duel decks for war and competitions. Share them with your friends.

new feature site

We’re excited to launch our Deck Builder today. This feature allows anyone to construct deck lists and war decks with ease.

Deck Builder is in early beta. It is optimized for mobile phones, but is usable on desktops and tablets. Optimized versions for desktops and tablets with additional functionalities will be added in the future.

Don’t want to read about it? Try it now! Login is required.

Try the Deck Builder

Update 2021-08-29: Published deck lists via Share will now be independent of the user deck lists. Details

Table of Contents


When your friends or clan mates ask you what decks you play in Clan Wars 2, how do you share your decks with them? Do you make screenshots of all of your decks? Do you share them one by one to the clan?

Besides building decks, one key feature of our Deck Builder is the ability to create shareable Deck Lists. These Deck Lists contain several decks in them, and with a single link, you can share a collection of decks with all of your friends.

So how do you go about creating such a list?

Create New Decks

When you first get to the Deck Builder, you won’t have any deck lists created. Start by selecting Create a new deck list (A).

  • Deck Collection is a collection of Deck Lists
  • Deck List is a collection of Decks

Edit Decks with Card Selector

When you tap on a card in a deck, the Card Selector opens up where you would perform most of your editing.

The Card Selector intelligently grays out cards that are already selected so you always know which ones remain available to build a valid deck.

  • Use the Delete Card (B) button to remove a card in the selected spot.
  • Filter cards by type (C). All, Troops, Spells, Buildings.
  • Sort cards (D). By rarity (Ascending / Descending) or elixir (Ascending / Descending).

🔥 Tip: You don’t have to select each empty slot one by one. If we detect that you are entering a new deck, we keep the Card Selector open and move the “cursor” automatically so you can enter all 8 cards at once.

If you already have a deck link (e.g. from the game), you can use the Edit icon (A) to enter the deck links directly into Edit Deck Link Text Input (B) field. This automatically updates the deck with the specific deck.

This input accepts any of the following 3 formats:

  • Clash Royale Deck Link
  • RoyaleAPI Deck Stats Link
  • Card Keys joined by commas
    • bandit,battle-ram,electro-wizard,fireball,magic-archer,pekka,royal-ghost,zap
  • Add Deck to Deck List

    Add more decks to the Deck List with the Add Deck button (A) with the + sign.

    Each deck list can have up to 20 decks.

    Deck List Title

    When you create a deck list, a random title is automatically generated for you. You can change this default title by tapping on the Name (A).

    Duel Mode

    The Duel Mode (A) toggle highlights duplicate cards in the deck list. Additionally, the card selector will highlight duplicate cards in red.

    The Card Selector will highlight duplicate cards in Duel Mode also, but won’t prevent you from entering duplicate cards. This allows you to build any optimum decks and then make decisions about what to replace afterwards.

    Deck Edit Menu

    Decks are shown with all the options by default.

    • Edit Deck Link (A). Enter deck links directly. See Edit Decks with Deck Links
    • Average Elixir (B). Shows the average elixir cost of a deck, the same value you see in-game.
    • 4-Card Cycle (C). Shows how quickly a deck cycles. For more information, read our blog post about it.
    • Open in Clash Royale (D). This sends the deck to Clash Royale if you are on mobile. It opens a QR code popup if you are on desktop, so you can scan it with your phone.
    • Delete Deck (E). Deletes the deck in the deck list.

    Info Toggle

    The Deck Edit Menu is shown by default, but you can turn if off by using the Info Toggle Button (A).

    When you have turned off Info view, tapping on cards no longer edit the decks. Instead, it opens the deck in Clash Royale.

    You can consider this as a toggle for these two views:

    • On: Edit Mode. All options on. You can edit the decks as well as open the decks in Clash Royale.
    • Off: Play Mode. All edit options off. Use this mode to prevent accidental deck edits. Tapping on decks open them in the game.


    The decks and deck lists in the Deck Builder are accessible to you only, and this access is tied to your login.

    Use the Generate deck list link (A) button to generate a public link to share with your friends.

    Once the link is generated, a separate panel opens where you can either Copy the deck list link (B) to share on social media, or Open the public deck list (C) to see what it looks like.

    👉 The public deck list is tied to your edits. If you make changes to your deck list after the deck list was published, the public deck lists will also update.

    👉 Update 2021-08-29: The public deck list is not tied to your edits. If you make changes to your deck list after the deck list was published, the published deck list will be the same as before. If you wish to share a revised deck list, just generate a new deck list link. Details

    Public Deck List

    The public deck list has a Show Dupes (A) toggle so you can easily see if there are dupes. This is useful for war decks and duel deck lists.

    🔥 The Public Deck List IDs are randomly generated. They are intentionally non-sequential. This ensures that people can’t guess the new deck lists being created for competitions.

    Anyone can Duplicate (B) the same deck list into their Deck Builder and edit it. This creates a new deck list unique to the user who copies it and will not affect the deck list created by its original creator.

    👉 Deck list title and author information are intentionally not published with the public deck lists. This ensures that their intended use cannot be easily identified. It also ensures that Deck Lists published to be used in competitions cannot be searched with search engines.

    👉 If you delete your deck list inside Deck Builder, the public deck list will also be removed.

    👉 Update 2021-08-29: If you delete your deck list inside Deck Builder, it will be removed from your Deck Collection, but your previously published deck lists will remain. Details

    Some esports leagues (e.g. CRL) that use the Duel game mode require players to submit a list of deck links to the league ops admin before the games are played.

    You can easily copy this list of deck links with the text field at the bottom of the page and paste onto Discord and other places.

    Deck Collection

    The Deck Collection is a list of your deck lists. Each item in the deck collection is a Deck List, which contains Decks.

    • Deck List Name (A)
    • Last Edited Timestamp (B)
    • Deck Count (C). Number of decks inside the deck list.
    • Trash (D). Delete the deck list.


    Saving is done automatically in the background as you edit your decks and deck lists. There is no save button.


    At launch, we have the following limits to the Deck Builder:

    • Each user can create up to 20 deck lists.
    • Each deck list can contain up to 20 decks.

    Contact us if you need higher limits and elaborate why you need them. This limit is currently in place to prevent spams, but we will increase it for power users who need them.


    Login is required to use the Deck Builder. This allows us to save your progress. It also allows you to edit your decks in multiple devices — you can start editing decks on your phone and continue on your computer or tablet.

    Because your decks in Deck Builder are tied to your login, logging in as another user (e.g. using another Discord / Twitter login) will consider you as a different user and you won’t see your collection with another login.

    If you absolutely want to edit with another login, you can use the Share functionality to publish a public deck list, and then duplicate it and edit with another login.

    Use Cases

    Here are some example scenarios where Deck Builder can be used.

    Clash Royale League

    Peter (player) is competing as a player in CRL and has asked Alex (analyst) to help him construct decks.

    • Alex creates a deck list with all 4 decks.
      • By toggling Duel mode, Alex has the confidence that none of the decks contain duplicate cards.
    • Alex publishes a public deck list and shares with Peter.
    • Since the deck list ID is not easily guessable, nor does it contain any author information, it prevents any potential deck leaks.
    • Peter opens the deck list and uses as is.
      • If Peter wanted to make edits, he can duplicate and edit in his own deck builder.
    • Peter copies the Deck Links at the bottom of the Deck List page and pastes the deck links on Discord to submit his 4 decks to the league ops / admin before his match starts.
      • This saves time and reduces errors as it doesn’t require him to copy and paste deck links one-by-one from the game to Discord.

    Clan Wars 2

    Oliver wants to create war decks to play in Clan Wars 2. After seeing how successful his war performances are, his clan mates ask him to share his decks with them.

    • Oliver creates a deck list with the war decks that he wishes to play.
    • Oliver enables the Duel Mode to ensure none of the cards are repeated.
    • Oliver shares his deck list with his clan mates by using the Share button.

    Examples: SML’s War Decks for 2021-08

    Expert Deck Builders

    William is really good at building decks, and his friends asked him to share his favorite Electro Giant decks on Twitter.

    • William opens the Deck Builder and creates 20 top decks using Electro Giant.
    • William publishes that list by using the Share button.
    • William uses the Copy Deck List Link button and paste into Twitter.
    • Now everyone can play his top decks.

    Example: 20 Electro Giant Decks


    How to save decks from Deck Search results to Deck Builder

    Update 2021-08-29

    We have changed how published (shared) deck lists work.


    • After publishing (sharing) a deck list, that deck list will automatically update to your latest edits.
    • When you delete that deck list from your collection, that publicly shared list will also be removed.


    When you publish a deck list, a duplicate of it will be created and shared.

    • If you edit your deck list again, that published copy will remain the same as before.
    • If you wish to share your edited deck list after you have published it, use the Share button in Deck Builder to publish again.
    • If you delete an already-published deck list inside your collection, it won’t show up in your collection anymore, but the published copy will remain.


    Try it out

    This feature is currently in early beta, and we’d love to hear what you think about it. We have many ideas already planned for future releases, but your opinions and feedback will help us develop these ideas further!

    Please write to us at RoyaleAPI Support or Twitter @RoyaleAPI if you have any suggestions, feedback or bug reports. It‘s equally helpful if you just tell us if the feature is useful — all feedbacks are welcome.

    Your feedback will be read by everyone on the team. Every idea will be considered. Thank you!


    new feature site

    Share this post

    Author: SML
    SML (See-ming Lee) is the Founder of RoyaleAPI. He is a Clash Royale completionist, and has one of the most complete emote collections in the world. Clash Royale Creator Spotlight

    Previous posts

    Global Tournament Rating CRL 2024 Preview Top Ladder Stats (January 2024) Leaderboard Decks - February 5 - End of January 2024 Season 55 Perfect Match - A free evolution and more news! Season 56 Explosive Valentine (February 2024) Wall Breakers Evolution - February 2024 (Season 56) Bomber Evolution - February 2024 (Season 56) Leaderboard Recap of 2023 Leaderboard Decks - End of December 2023 Season 54 Final Balance Changes for January 2024 (Season 55) Cannoneer, the new Tower Troop Season 55 Valhalla (January 2024) Trending SuperCreators (2023-12) Valkyrie Evolution - January 2023 (Season 55) Work-in-progress Balance Changes for January 2024 (Season 55) 20 Win Challenge Stats of 2023 Final Balance Changes (December 13, 2023 Q4, Season 54) Tower Troops Update (December, 2023 Q4) Season Shop Tier List (December 2023, Season 54) Leaderboard Decks - End of November 2023 Season 53 Season 54 Naughty or Nice (December 2023) Level 15 in Path of Legends - December 2023 (Season 54) Ice Spirit Evolution - December 2023 (Season 54) Little Prince Balance Changes for November 17, 2023 (Season 53) Final Balance Changes for November 2023 (Season 53) Leaderboard Decks - End of October 2023 Season 52 Cheaper Pass Royale with Google Play Games on PC? Little Prince In-Depth Guide, New Champion - Season 53 (November 2023) Season 53 Little Prince, Big Trouble (November 2023) Little Prince, New Champion - Season 53 (November 2023) Night Witch Papercut DIY - Season 52 (October 2023) Archers Evolution - Season 53 (November 2023) October 2023 Update Clash Royale on a PC with Google Play Games CRL 2023 Card Experts User Survey - Global Tournament Leaderboard Leaderboard Decks - End of September 2023 Season 51 Bats Evolution - Season 52 (October 2023) Season 52 Clash-O-Ween (October 2023) Final Balance Changes for October 2023 (Season 52) Work-in-progress Balance Changes for October 2023 (Season 52) Best Ways to Buy Elite Wild Card with Gold - September 2023 Update Leaderboard Decks - End of August 2023 Season 50 Season 51 King’s Gambit (September 2023) Royal Recruits Evolution - Season 51 (September 2023) Hog Rider and Hog Giveaway - Season 50 (August 2023) Knight Evolution - Season 50 (August 2023) Final Balance Changes for August 2023 (Season 50) Season 50 Clash-A-Rama (August 2023) Season Shop Buying Guide Work-in-progress Balance Changes for August 2023 (Season 50) Best Ways to Buy Elite Wild Card with Gold Player Leaderboard by Card at End of Season Dark Elixir - New Game Mode Balance Changes for July 2023 (Season 49) Evolved Mortar - July 2023 New Card Season 49 Evolution Origins (June 2023) More - 2023 Q2 Summer Update Evolved Royal Giant - 2023 Q2 Summer Update Evolved Firecracker - 2023 Q2 Summer Update Evolved Skeletons - 2023 Q2 Summer Update Elite Levels - 2023 Q2 Summer Update Card Evolution - 2023 Summer Update Final Balance Changes for June 2023 (Season 48) Season 48 Get Ready for Evolution (June 2023) Work-in-progress Balance Changes for June 2023 (Season 48) Slash Royale, Level 15 and Upgrades without Gold Boost Fields - New Game Mode Mega Monk - New Game Mode Champion Clash Classic Decks Season 47 Books of Clash + Super Champion Hog Rider (May 2023) Super Archer vs Golems - New Game Mode Every Super Card in Clash Royale Final Balance Changes for April 2023 (Season 46) Season 46 Boot Camp (April 2023) Work-in-progress Balance Changes for April 2023 (Season 46) Update for Losers - 2023 Q1 Game Update Sneak Peek Season Shop and Events 2.0 - 2023 Q1 Update Preview State of the Meta - Cards and Decks for February to March 2023 Season 45 Goblin Party (March 2023) Where is the Gold? Clash Royale 2023 Roadmap Final Balance Changes for February 2023 (Season 44) Season 44 Love and Magic (February 2023) Clash Royale League (CRL) 2023 Work-in-progress Balance Changes for February 2023 (Season 44) Visualize your CW2 progress State of the Meta - Popular Cards and Decks on the Path of Legends (Ranked Mode) in December Season 2022 Duel Deck Search Season 43 Frost Festival (January 2023) Best of Clash Royale 2022 - Survey and Giveaway Card Matchup - New Feature December Q4 2022 Update Final Balance Changes for December 2022 (Season 42) Season 42 Clashmas (December 2022) Work-in-progress Balance Changes for December 2022 (Season 42) New Leaderboards for Player Stats Emergency Balance - Phoenix (November 21, 2022) New Achievement Badges on Player Profile State of the Meta - Popular Cards on the Path of Legends (Ranked Mode) in October Season 2022 Season 41 Silent Sanctuary (November 2022) Chest Cycle - 2022 Q3 Update Balance Changes and more - 2022 Q3 Update Phoenix - New Legendary Card Monk - New Champion Card Welcome to the Path of Legends - Biggest Update of the Year! Season 40 Clash-o-ween (October 2022) Final Balance Changes for October 2022 (Season 40) Work-in-progress Balance Changes for October 2022 (Season 40) Most Popular Cards on Top Ladder in August Season 2022 Season 39 Clash Fest (September 2022) Season 38 Classic Decks Matchups (August 2022) CRL 2022 20-Win Challenge Cards and Decks CRL 2022 20-Win Challenge Winners by Region Over Time CRL 20-Win Challenge 2022 Winners by Country RoyaleMSTRS Gold Edition Season 38 Clash From The Past (August 2022) Final Balance Changes for August 2022 (Season 38) Work-in-progress Balance Changes for August 2022 (Season 38) Clash Royale League (CRL) 2022 Summer Qualifiers Most Popular Cards on Top Ladder in June Season 2022 Season 37 Mini Pekka’s Dream (July 2022) Summer Update (June 2022, Q2 Update) Creator Spotlight - RoyaleAPI Season 36 Bone Pit (June 2022) Final Balance Changes for June 2022 (Season 36) Work-in-progress Balance Changes for June 2022 (Season 36) First person to max Mastery - Juuso14 Content Creator Badges Most Popular Cards on Top Ladder in April Season 2022 Season 35 Bewitched (May 2022) Card Mastery Levels of Top 1000 Players Most Popular Cards on Top Ladder in March Season 2022 Ladder and Global Tournament Ranked Badges Season 34 Mighty Mine (April 2022, Q1 Update) Balance Changes - 2022 April (Season 34) Clash Royale releases China-specific version. What does it mean to you? When will that juicy chest arrive? Season 33 Birthday Royale (March 2022) New Challenge Badges Season 32 Lava Hound (February 2022) Balance Changes - 2022 February (Season 32) Clash Royale League (CRL) 2022 FAQ Clash Royale League (CRL) 2022 Overview Player King Levels and Best Trophies Ladder Finish Leaderboard 2021 15 Arena Challenge (Jan 8 - Jan 29) Happy New Year 2022! Season 31 New Year (January 2022) Country Info on Player Leaderboards Player Earnings Leaderboard Balance Changes - 2021 Q4 Winter Update (Season 30) Season 30 Clashmas - Seasonal Content 20-Win Challenge Odds Cards - Average Crowns by Win-Condition Champions Card Trends Advanced Deck Cycles for Champions (2nd Edition) Champions Balance Changes (November 2021) Your next Royal Wild Chest Advanced Deck Cycles for Champions Champions Update and Season 29 Sneak Peek Reaction to Sneak Peek Animation King Level 14 - 2021 Autumn Game Update CRL 2021 Best Players by Win Condition Slash Royale - Earn over 300k Gold! Season 28 Shocktober - Sneak Peek Custom Achievement Badges - New Feature Esports Achievement Tiers - New Feature Complete CRL Survey, win Clash Fan Box Season 27 Executioner’s Kitchen - Sneak Peek Balance Changes - 2021 Q3 Autumn Update (Season 27) Deck Builder - New Feature Season 26 Cruise Royale - Sneak Peek RoyaleAPI Birthday Survey and CRL Swag Box Giveaway Season 25 Vacation Royale - Sneak Peek Leaderboard Decks by Season - New Feature Season 24 Rumble in the Jungle - Seasonal Content Summer (2021 Q2) Game Client Update (Season 24) Balance Changes - Summer (2021 Q2) Game Client Update (Season 24) How to fix Facebook friends not showing up on Friends List Season 23 Golden Dragon Spa - Seasonal Content 4-Card Cycle - Shortest Path to the Same Card Season 22 Pekka’s Playhouse - Seasonal Content Magic Items - 2021 Q1 Game Client Update Balance Changes - 2021 Q1 Game Client Update Clash Royale League (CRL) 2021: Round 1 Stats Season 21 Birthday Royale Battle Healer Emote Giveaway Tournaments Season 21 Birthday Royale - Seasonal Content Clash Royale League (CRL) 2021 Rules - Visualized Which cards should never appear in the starting hand? - Survey Results Underleveled players who finished in Ladder Top 1000 in Season 2021-01 Season 20 The Forbidden Palace - Seasonal Content Ranked Seasons - Is Your Best Finish Really Your Best? Most requested changes about Clan Wars 2 - Survey Results Player Clan Wars 2 History Season 19 Frozen Peak - Seasonal Content Happy New Year 2021! Ladder Trophy Balance Change - Data Visualization Season 18 - Balance Changes, Mother Witch (New Card), Seasonal Content CRL 2020 World Finals Preview Search Decks by Average Elixir RoyaleAPI Content Partner Program Deck Search Helper - a utility to find war decks for Clan Wars 2 Game Client Update - November 18, 2020 (Season 17) The Secret Stats - A Deep Dive into Hit Time, Load Time and First Hit in Clash Royale Season 17 - Balance Changes and Seasonal Content Join / Leave Log in Clan History Clan Wars 2 Tools for Clash Royale Clan Leaders - Analytics, Log and More Season 16: Balance Changes, Electro Spirit + Electro Giant (2 New Cards), Shocktober Update Deck Search - Sort by Rating Season 15 - Balance changes, seasonal content and more! Supercell Creators Clan Wars 2 Tournament The two professional labels - what’s the difference? Classic Decks (Season 14) Matchups Clan Wars 2.0 - Update 2 Season 14 - Balance changes, seasonal content and more! RLS Practice - Play our tourney-standard ladder to prepare for the 20-win challenge! Account Age - New Feature Classic Decks (Season 13) Matchups Double Barrel Bait 2.9 - Deck Spotlight Clash Royale Fanbox Giveaway Season 13 - Balance changes, seasonal content, 20-win challenge and more! Clan Wars 2.0 - The most anticipated Clash Royale update Emote Log - New Feature Classic Decks (Season 12) Matchups Season 12: Skeleton Dragons (New Card), Balance Changes, Emotes, New Arena, and More! Classic Decks (Season 11) Matchups Translate for Us! Royal Giant 2.9 Cycle - Deck Spotlight Season 11: Balance, Content Update and more - May 2020 Update Classic Decks (Season 10) Matchups Battle Replay Overlay for Streamers Royal Hogs Heal Spirit - Deck Spotlight Season 10: Balance, Heal Spirit (New Card) and more - April 2020 Update CRL East 2020 Details Player Leaderboard by King Level Expanded to Top 1000 Season 9 Classic Decks Matchups 3M Royal Hogs (Ladder #1 by Siro) - Deck Spotlight Leagues: Filter by Players and Teams on Card Stats and Deck Stats Royal Hogs Delivery - Deck Spotlight Season 9 Birthday Royale Pekka Emote Giveaway Tournaments Season 9: Birthday Royale, Royal Delivery (New Card), Balances, Classic Decks - March 2020 Update Classic Decks (Season 8) Matchups Launch of Clash Royale League East! Battle Replay - New Feature Royal Hogs Zappies - Deck Spotlight Season 8: Balance and Classic Decks - February 2020 Update Wall Breakers Miner Cycle - Deck Spotlight Classic Decks (Season 7) Matchups Discontinuing API service for developers — Will not affect website Pekka BridgeSpam - Deck Spotlight Free Agents Season 7: Firecracker, Balances, Classic Decks - January 2020 Update Classic Decks (Season 6) Matchups Meet the CRL World Finalists Season 6: Balance, Battle Healer, Classic Decks - December 2019 Update Classic Decks (Season 5) Matchups Season 5: Balance and Features - November 2019 Update Season 4: Balance and Classic Decks - October 2019 Update Matchup - New Feature Tiebreaker, Triple Draft and more - September Client Update Season 3: Balance and Classic Decks - September 2019 Update Season 2: Balance and Classic Decks - August 2019 Update Season 1: July Update: Pass Royale and more Classic Decks, June 2019 Update April 2019 Update January 2019 Update Ram Rider December 2018 Update #2: New Tournament System December 2018 Update #1: Star Levels Classic Decks, September 2018 Update Goblin Giant, Trade Tokens, Simplified Card Levels - September 2018 Update Clan Wars 2v2 Guide: Golem Summer 2018 Update #2 Summer 2018 Update #1 Deck performance against meta decks + Official Partners Clash Royale League Portal Counter Decks + Grand Challenge Portal
    Creator Code Support us with creator code RoyaleAPI
    Donate to support us