> For the complete documentation index, see [llms.txt](https://swu-forge.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swu-forge.gitbook.io/docs/account/settings.md).

# Settings

Access your settings from the **user menu** (click your avatar in the top-right) and select **Settings**, or navigate directly to `/settings`.

## Account Info

Your settings page shows your **email** and your current **membership tier** (if any). The **Membership** section under Subscription shows your current plan and renewal date, with a **Manage subscription** button to update payment, switch plans, or cancel. See [Membership & Subscriptions](https://swu-forge.gitbook.io/docs/account/membership.md) for how subscribing and billing work, or [Getting Started](https://swu-forge.gitbook.io/docs/getting-started.md) for what each tier unlocks.

![Screenshot: Settings page showing account info with subscription tier](https://cdn.swuforge.com/how-tos/settings-account-tier.png)

### Product update emails

A roughly weekly email about what's new on SWU Forge. It's on by default — switch it off here and you'll stop receiving it.

Turning it off only affects that update email. You'll still get the messages that come with having an account: team invitations, subscription receipts, and replies to anything you send through support.

Every update email also carries an **Unsubscribe** link at the bottom, which does the same thing without needing to sign in — handy if you're reading on a phone.

Whether you take the email or not, every update is also published on the [Blog](https://swu-forge.gitbook.io/docs/more/blog.md), reachable from the user menu.

### Display Name

The name shown next to your avatar in the navigation bar, battle log, and team rosters. It starts out as the name from the account you signed in with — you can change it anytime by typing a new value and clicking **Save**. Names must be between 1 and 50 characters.

### Avatar

The picture shown next to your name. By default this is the avatar from the account you signed in with. Click **Upload avatar** to pick your own image:

* **JPEG, PNG, WebP, or animated GIF** are supported.
* **Max 5MB** for static images, **3MB for GIFs**. Static images are automatically center-cropped to a square and resized; GIFs are uploaded as-is so animation is preserved.
* Click **Replace avatar** to swap it for a new picture, or **Remove** to go back to a placeholder.

## Connect with Discord

Link your Discord account to get your subscriber role in the SWU Forge Discord. Once you're connected, this section shows your SWU Forge Discord role and has a **Refresh my role** button for when you join the server after connecting. See [Connect with Discord](https://swu-forge.gitbook.io/docs/account/connect-discord.md) for the full walkthrough.

## Cards & Decks

Settings for how cards and decks look and how you search for them, across Browse, the workshop, and deck pages.

### Search

These settings control how search works on the home page, the Browse page and the Workshop.

#### Plain Language Search

Turn this on to describe what you want in your own words instead of writing filters yourself. Your description is translated into filters, which then appear in the search bar so you can see exactly what was matched and adjust it.

This setting, and the opt-out below, appear only if your membership is **Foundry Apprentice** or above.

#### Opt out of AI queries

Turn this on to keep every search structured — nothing you type is ever sent to the language model, on the home page or anywhere else. This also turns Plain Language Search off.

#### Show preview cards

On by default. While a new set is being spoiled, its cards appear in search alongside everything else. Turn this off to search only released cards. Either way you can still add preview cards to decks. See [Preview Cards](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards/preview-cards.md).

This setting only appears while a set is actually in spoiler season.

#### Filter syntax

Choose the style filters are written in:

* **Forge Syntax** — Function-call filters like `trait(rebel) cost(>4)`. See the [Syntax Search Reference](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards/search-syntax.md).
* **Scryfall Syntax** — Prefix filters like `tr:rebel c:r p>3`. See the [Scryfall Syntax Reference](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards/scryfall-syntax.md).

This applies whether you type filters yourself or Plain Language Search fills them in for you, so pick whichever style you'd rather read. Typing the other style is also enough to switch — your preference follows what you actually use.

On desktop you can change all of these from the search bar dropdown without visiting Settings. All of them persist across sessions.

### Card Display Preferences

Three toggles control which card art variants are displayed throughout the app — in search results, deck views, the workshop, share images, and proxy prints.

#### Showcase Art

Display **showcase (alternate art)** versions of leader cards when available. These are special art treatments with unique illustrations.

#### Prestige Art

Display **prestige (extended art)** versions when available. Prestige art extends the illustration beyond the normal card frame. Note: prestige art is **front-only** — the back side always uses the standard art.

#### Hyperspace Art

Display **hyperspace** versions of cards when available. These feature a distinct visual style with hyperspace-themed borders.

![Screenshot: Card display preference toggles](https://cdn.swuforge.com/how-tos/settings.png)

### Art Priority

When a card has multiple variant arts available, the priority order is:

**Showcase > Prestige > Hyperspace**

For example, if you have all three toggles enabled and a card has both showcase and prestige art, the showcase version will be shown. If a preferred variant's image fails to load, the app automatically falls back to the standard art.

### Filter Layout

Choose how filters appear on the browse and workshop pages. The setting presents visual previews of each layout option — click one to select it.

#### Default Filters

Standard dropdown filters for **Type**, **Arena**, and other filter categories. This is the default layout.

#### Card Type Macros

Replaces the **Type** and **Arena** filter dropdowns with quick-filter buttons:

* **Space** — Shows space units
* **Ground** — Shows ground units
* **Events** — Shows event cards
* **Upgrades** — Shows upgrade cards

These buttons work like radio buttons — only one can be active at a time. Click the active button again to deselect it.

When this layout is active on [Browse](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards.md), the **Type** dropdown is reduced to just **Leader** and **Base**, and the **Arena** dropdown is hidden (since arena filtering is handled by the Space/Ground buttons). In the [workshop](https://swu-forge.gitbook.io/docs/decks/workshop.md), the **Sets**, **Type**, and **Arena** dropdowns are all hidden, and the Premier/Eternal button in the search bar shows which card pool you're searching. Nothing else is taken away — Power, HP, Cost, Keyword, Ability, Trait, and Rarity stay right where they are, on [Browse](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards.md) and in the [workshop](https://swu-forge.gitbook.io/docs/decks/workshop.md) alike.

This setting applies to both the desktop filter bar and the mobile filter panel.

### Card Rows

Choose how compact card rows look — the deck page's list view, Browse's list view and deck panel, and the workshop's search results and deck lists. Pick the preview that matches what you want:

* **With card art** (the default) — a sliver of the card's art sits behind the name and stats.
* **Plain rows** — just the count, name, cost, and stats.

The setting follows your account, so rows look the same on every device you sign in on.

### Grid Density

Control how many card columns are displayed at full width across the app — in search results, the workshop deck grid, and deck previews.

Click one of the four density options:

* **6** (default) — Standard density, best for typical monitors
* **8** — Slightly smaller cards, fits more on screen
* **10** — Compact view, uses lower-quality images for faster loading
* **12** — Maximum density, uses lower-quality images for faster loading

The same number of cards per row shows everywhere — Browse, the workshop, and your deck pages. On a narrow panel where the cards would get too small, fewer fit and the row holds as many as it can. On a phone, card size is fixed instead: Browse and the workshop show 2 cards per row, and deck pages show 3. At densities of 10 or 12, the app switches to smaller thumbnail images to keep loading fast.

**Adjusting one page.** Browse, the workshop, and the deck page each have a card size control next to the Grid/List switch, showing the current number of cards per row. Change it to show bigger or smaller cards on that page only. Each page remembers its own choice on this device, and your Grid Density setting stays the same. Picking a density here again resets all three to it. Phones don't have this control.

### Deck Grouping

How the main deck is arranged every time you look at a deck — the [deck page](https://swu-forge.gitbook.io/docs/decks/managing-decks.md), the deck panel on [Browse](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards.md), and the [workshop](https://swu-forge.gitbook.io/docs/decks/workshop.md). Pick one:

* **Cost** (default) — one list, cheapest cards first
* **Card Type** — sections for Ground Units, Space Units, Events, and Upgrades
* **Aspect** — a section per aspect combination, so Vigilance, Vigilance + Villainy and Villainy each get their own; cards with no aspect come last
* **Set Order** — a section per set, newest first

Each of those views has its own **Group** dropdown with the same choices, so you can change grouping on the spot without coming back here. Whatever you pick last is what all three views use next time.

Your **maybe board** is arranged the same way as the main deck. Sideboards are left alone: they always stay a single list under the main deck, whichever grouping you choose.

## Collection

This section appears once you're signed in. These options change how your collection counts when you build decks from it.

### Limit to owned copies

On by default. While **Build from collection** is on, you can't add more copies of a card than your collection holds. Turn it off if you plan to buy or borrow the rest: you can then add up to the normal limit, and copies you don't own are marked **Missing**. This is the same option that appears beside **Build from collection** in the filters, so changing it in one place changes it in the other.

### Hide used-up cards

Off by default. While **Limit to owned copies** is on, cards whose copies are all in your deck are shown faded in the results. Turn this on to leave them out instead. This is the same option that appears beside **Limit to owned copies** in the filters. See [Seeing what you have left](https://swu-forge.gitbook.io/docs/collection/collection.md#seeing-what-you-have-left).

### Foils and playsets

Whether foils count toward a playset is set for each collection on the Collections page's **Playsets** tab. See [Defining a playset](https://swu-forge.gitbook.io/docs/collection/collection.md#defining-a-playset).

## Battle Log & Replay

Settings for recording, reviewing, and watching your games.

### Battle Log View

How the [Battle Log](https://swu-forge.gitbook.io/docs/battle-log/battle-log.md) lists what you've recorded — as a **Card Grid** or a **Table**. You can still switch view from the Battle Log itself, and whichever you land on is remembered here.

### Replay

Controls how recorded games play back when you open a replay from the [Battle Log](https://swu-forge.gitbook.io/docs/battle-log/battle-log.md).

#### Legacy Replay Viewer

Replays play on an animated board: cards fly from hand to arena, pilots drop into their ships, and attacks play out. Turn this on to watch them in the classic step-by-step view instead.

Switching it on asks you to confirm first. The legacy viewer lacks new features like replay comments and review requests, and it will soon be removed entirely. If you need it for something, the dialog links you to Discord so you can tell us why.

This one is remembered **for the browser you're using**, so switching it on at your desk doesn't switch it on for your phone. The same toggle also lives in the user menu behind your avatar, if you'd rather flip it without leaving the page you're on.

#### Playback speed

The speed replays start at when you press play: **0.5×**, **1×**, **1.5×**, **3×**, or **8×**. You can still change speed mid-replay from the scrubber, and whichever speed you land on is remembered for next time.

## Connected Services

If you've linked SWU Forge from a game site, such as Karabast, so that it sends your finished games here, the link is listed in this section. Each link shows which of your profiles its games are saved to. If you linked more than one login, each one has its own row.

Click **Unlink** to stop a site from sending your games. You're asked to confirm first. Games it already sent stay in your Battle Log. To link again, start from the game site's own settings.

The section only appears once you have at least one link.

## Your data

### Export your data

Download your games, matches, decks and deck cards as CSV (for spreadsheets) or JSON (for scripts), and find your way to your collection's download. Each kind of data shows how much of it you have. Pick the format once at the top; it's used for every download on SWU Forge and remembered in this browser. See [Exporting Your Data](https://swu-forge.gitbook.io/docs/account/settings/export-your-data.md).
