Direct Linking

Direct linking lets you create URLs that automatically prefill Magic: The Gathering® decklists, player info, and event details on Decklist.gg.

Tournament organizers can prefill event details so players only need to add their decks. Deck builders can share complete lists with a single link. Teams can distribute standardized decklists before events. Other apps can also integrate with Decklist.gg by generating direct links, giving their users instant access to prefilled Magic: The Gathering® deck registration sheets.

No matter how you use it, direct linking makes sharing and managing decklists fast, consistent, and reliable.

How it works

Decklist.gg links use URL parameters to prefill and configure the app automatically. When someone opens a link that includes parameters, the app will:

1. Load the specified decklist and format.
2. Fill in player and event details (if provided).
3. Open directly to the Preview step (if set).
4. Generate a ready-to-download PDF decklist.

Share links

You can manually build shareable URLs or generate them programmatically, but the Share button on the Preview step does it for you automatically. It creates a properly encoded URL based on your current configuration and copies it to your clipboard — no manual setup required.

To create a share link in the app:

1. Navigate to the homepage.
2. Choose Import decklist or Enter manually.
3. On the Deck step, select a format and finalize your decklist.
4. On the Registration step, add player or event details (optional).
5. On the Preview step, click the Share button at the top of the page.

Your fully encoded decklist link will be copied to the clipboard and ready to share.

URL parameters

Each parameter adds specific information to your link. You can mix and match them freely — any field you leave out will simply remain blank.

Use these parameters when building links manually or when integrating Decklist.gg with another app or site. The following sections explain each parameter in detail, including setup examples.

Deck parameters

These parameters allow you to set the decklist and format.

Decklist format

When encoding a decklist, each card should appear on its own line %0A. Start with the quantity, followed by a space %20, then the card name. You can use just a number or a number followed by an x.

Here are some examples of valid formats (pre-encoded):

Lightning Bolt 
4 Lightning Bolt 
4x Lightning Bolt 
4 Lightning Bolt (DMR)

4: Lightning Bolt 
Lightning Bolt x4 
Lightning Bolt 4 
Lightning Bolt * 4

Section headers

You can separate the deck into sections using headers. If no header is provided, cards are added to the mainboard. Section headers are case-insensitive:

Examples

https://decklist.gg/?decklist=4%20Lightning%20Bolt%0A4%20Mountain

https://decklist.gg/?format=modern&decklist=4%20Lightning%20Bolt%0A20%20Mountain%0ASideboard%0A3%20Shock%0A2%20Smash%20to%20Smithereens

https://decklist.gg/?format=commander&decklist=Commander%0A1%20Atraxa%2C%20Praetors%27%20Voice%0AMain%0A1%20Sol%20Ring%0A1%20Command%20Tower%0A97%20Forest

Registration parameters

You can include player, deck, and event details using the parameters below. Users can still edit these fields after the link is opened.

Example

https://decklist.gg/?event=Friday%20Night%20Magic&date=2025-10-11&location=Local%20Game%20Store&step=registration

UI parameters

UI parameters control how the site opens when the link is visited. Currently, a single parameter is supported.

Including step=preview opens the link directly in preview mode, where decklist PDF is generated automatically. This is recommended when linking to Decklist.gg from external apps or sites.

Example

https://decklist.gg/?firstName=John&lastName=Doe&event=FNM&deckName=Burn&format=standard&decklist=4%20Lightning%20Bolt%0A20%20Mountain%0ASideboard%0A3%20Shock&step=preview

Encoding basics

Decklist.gg supports standard URL encoding, which ensures your decklists, player names, and event details load correctly. Most browsers and apps will handle encoding automatically, but if you’re creating links manually or generating them in code, make sure to encode special characters properly.

Below are some common encoding rules to follow:

Tip: When encoding URLs in JavaScript, use encodeURIComponent() to safely escape special characters.