> 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](/docs/account/membership.md) for how subscribing and billing work, or [Getting Started](/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)

### 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.

## Search Mode

Choose which search mode to use on the Browse and Workshop pages:

* **Syntax Search** — Free for all users. Uses structured filter expressions to find cards. See the [Syntax Search Reference](/docs/cards-and-search/searching-cards/search-syntax.md) for the full list of filters and examples.
* **Plain Language Search** — Describe what you want in your own words and the search figures out the filters. Requires a **Foundry Apprentice** subscription or above. If you don't have an active subscription, the Plain Language Search option links to the [subscription page](https://swuforge.com/subscribe) where you can subscribe.

On desktop, you can also switch search modes directly from the search bar dropdown without visiting Settings.

Your search mode preference persists 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.

## 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 grid automatically adapts to your screen size. On smaller screens or narrower panels, columns will wrap and reduce regardless of your density setting. At densities of 10 or 12, the app switches to smaller thumbnail images to keep loading fast.

## 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, 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).

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://swu-forge.gitbook.io/docs/account/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
