Editing & Syncing Components in a Room

This is one of the most useful concepts to understand, and the one that confuses people most. Every piece in a playtest room is a Table Component, and most of them are tied to a Project Component saved in your project. Knowing which of the two you are changing lets you fix and tweak things mid-playtest without breaking your table.

Your project's Components page holds the Project Components; every piece you spawn onto the table is a Table Component you can sync with its Project Component

Project Components and Table Components

A Project Component is the component saved in your project, on its Components page: its name, art, size, colors and the rest. It is the source of truth, and every new spawn is made from it.
A Table Component is a piece in a playtest room: on the table, inside a deck, stack or bag, or in someone's hand. Spawning a Project Component makes a Table Component of it. You can move, flip and rotate a Table Component freely without touching its Project Component.
A piece spawned from the sidebar's Generic tab is a Table Component that is not in your project. It has no Project Component until you save it as one.

Important

Saving a Project Component does not change its Table Components by itself. They keep the old version until you choose Apply when the room asks, use Restore from Project Component or Resync, or spawn fresh ones.

Which One Am I Editing?

The room tells you in two places.

In the right-click menu. Right-click a Table Component that is linked to a Project Component and open its Component submenu. Above Edit Project Component… a status line reads Matches its Project Component or Differs from its Project Component. Hover it to see which settings differ. The line only appears when the room has that Project Component loaded, and not for decks or stacks, which hold several pieces.

In the editor window. Its title is Edit Project Component or Edit Table Component. Under the title of a Project Component, a path shows where it lives: your project's name, then Components, then its deck or group name if it has one, then its own name. The project name and Components link to those pages. Below the tabs, a line depends on how you opened the window:

From a piece on the table: whether that Table Component matches its Project Component. When it differs, the line lists the settings that differ (for example Front art, Color or Size) and offers a Restore from Project Component button.
From the sidebar: how many Table Components of it are in the room, counting the table, decks and hands.
From a generic piece: that this Table Component is not in your project, so changes apply to this piece alone, with a Save as New Project Component button.

The comparison covers the settings Restore from Project Component would change, such as name, art, shape, colors, size, snap tags, drawings and stickers. Where a piece sits, and which way up it is, never counts as a difference.

The Component Menu

Editing, saving and restoring are host only. For a Table Component linked to a Project Component, the Component submenu offers:

Edit Project Component… opens the editor on the Project Component without leaving the room. Its save button is Save Project Component.
Save to Project Component pushes this Table Component's current state up to its Project Component: its name, its size as drawn on the table, rotation (to the nearest quarter turn), colors, art, shape, snap points, snap tags, marker strokes, stickers and labels, plus the faces of a die, the sections of a spinner and the grid of a board. A piece you scaled up or down is saved at that size, with its snap points, labels and board grid saved to match. The room then asks Update Table Components?: Update All brings the other Table Components of it on the table, in decks and in every player's hand in line, and Skip leaves them as they are.
Save as New Project Component saves this Table Component as a brand-new Project Component, named after it with "(copy)" added, and links this piece to the new one. The original Project Component, and every other Table Component of it, stays as it was. Not offered for decks or rulebooks.
Restore from Project Component pulls the Project Component's latest version down. It refreshes every Table Component of that Project Component at once, not just the one you clicked.
Select All Same Component selects every Table Component of the same Project Component. Ctrl+A selects by mask instead (see Keyboard Shortcuts).

For a generic piece, which has no Project Component, the submenu offers:

Edit Table Component… opens the same editor on this one piece. Its save button is Apply to Table Component, and the change applies to this piece only.
Save as New Project Component saves the piece into your project and links it to the new Project Component, so you can spawn it again next session.
On a deck, Save Cards as Project Components (n) saves each card as its own Project Component. On a token stack, Save Stack as Project Components (n) does the same for each token; it sits in the stack's Stack submenu. Every card or token is linked to its new Project Component.

Worked Example: Fixing Art Mid-Playtest

A tester points out a confusing card:

Right-click the card and choose Component → Edit Project Component….
Swap in the corrected art and click Save Project Component.
The room asks Apply to Table?: "Project Component saved." followed by how many matching Table Components it will update on the table, in decks and in hands. Click Apply.

Apply updates every Table Component of that Project Component at once: the ones on the table, the cards inside decks and stacks, and cards held in hands. Everyone in the room sees the new art immediately, with no re-spawning and no need to close the room. Choose Not Now to keep the old version on the table for the rest of the game; the Project Component is saved either way.

You don't have to restore Table Components one at a time. Restore from Project Component on any one of them refreshes every Table Component of that Project Component, so it is also the way to catch the table up after you chose Not Now, or after editing the Project Component on the Components page. To catch up every Project Component in the room at once, open the Save & Sync panel in the bottom toolbar and click Resync.

Tip

Built a piece by feel from the sidebar's Generic tab and want to keep it? Save as New Project Component files it into your project so you can spawn it again next session.

Drawings, Stickers and Labels

Resync never removes a drawing, sticker or text label a Table Component already has, so whatever was drawn or stuck on a piece at the table survives it. That includes cards synced from Dextrous, whose feed carries no drawings. If the Project Component has drawings, stickers or labels the piece does not have yet, Resync adds them to the pieces on the table and in decks and stacks.

Restore from Project Component, Apply and Update All work the other way on the table and in decks: they reset a piece's drawings and stickers to its Project Component's, so anything drawn at the table is replaced.

All four of them, Resync included, also put each Table Component on the table and in hands back at its Project Component's size, so a piece scaled up or down at the table returns to the size saved in the project. Its snap points, text labels and board grid move with it and stay where they were on the artwork.

Cards Inside a Deck

Syncing updates cards that are sitting in a deck on the table too, in place. The deck's order is not changed. A sync refreshes each card's art and details and leaves the pile arranged exactly as you had it.

If a card's Project Component has been deleted from the project, Resync looks for a Project Component with the same name and links the card to it, in the same spot in the deck. A card somebody is holding is re-linked the same way, in their hand. A card with no match is left exactly as it is rather than being swapped for a different one, and the sync tells you how many were left as-is so you can decide what to do with them.

Cards In Players' Hands

Apply, Restore from Project Component, Resync and Update All all reach Table Components people are holding, not just the ones on the table. A card in your hand picks up its new art and details in place, and so does a card in somebody else's hand, without anyone having to put it down and pick it back up first.

This works for guests as well as signed-in players, because the refreshed details travel with the sync itself rather than each player having to go and fetch them.

When the Link Is Broken

If a Table Component's Project Component no longer exists (it may have been deleted and recreated), Restore from Project Component opens the Project Component Link Broken window instead. Search your project's components and pick a replacement to re-link that piece to it.