# Updates

> Every time we release a new update, you can access the new files via the Customer Portal. We provide updates to align with the latest shadcn/ui releases and incorporate user feedback. We also aim to provide updates when there's a new Figma feature or shadcn/ui component.

Canonical: https://www.shadcndesign.com/docs/updates

## How to get new updates?

Log in to our [Customer Portal](https://polar.sh/shadcndesign/portal) with the email you used to make the purchase.

If you don't remember which email you used, try every address you might have used. If you're still stuck, contact us at [hi@shadcndesign.com](mailto:hi@shadcndesign.com).

### Code not arriving?

- Wait 5 minutes for the server to process the request.
- Make sure your mail server can accept messages from the @polar.sh domain.
- Check your junk/spam inbox.
- If none of the above works, contact our partner: support@polar.sh

---

## How do the updates work?

In our framework, updates are new Figma files that most often introduce new components or blocks, along with minor fixes and refinements. You can keep using your current version without disrupting your workflow.

Keep in mind that **Figma is file-based, not a code repository**, so updates can't be installed automatically like software packages. When we publish an update, it won't appear in your Figma library on its own, nor can it be "installed" with a single action.

Given this, we recommend copying over any new components you need from the updated file into your existing project. This lets you selectively incorporate the improvements most relevant to your work.

We rarely release major updates — usually when the official shadcn/ui receives a significant change. In those cases it's best to stick with the version you started your project on. Updating to a newer major version can be challenging because Figma treats each file separately: you'd need to manually transfer new components and tokens, which is harder still if you modified tokens or added your own components. We therefore recommend adopting new major versions only for new projects.

---

## Adding new components to your library

This guide shows how to add new components from the latest shadcn/ui Figma kit to an existing custom library based on an older version, while preserving your styling.

<LoomEmbed videoId="b1e682f428524d51b63625b7dfc8eb82" />

### Prerequisites

- Figma Pro account (or higher) for publishing libraries
- Your custom library based on an older shadcn/ui kit for Figma
- The latest version of the shadcn/ui kit for Figma
- The Swap Variables Figma plugin

### Step-by-step guide

#### Step 1: Open libraries

1. Open your custom library file in Figma.
2. Open the latest shadcn/ui kit for Figma file.

#### Step 2: Publish libraries

1. [Publish](https://help.figma.com/hc/en-us/articles/360025508373-Publish-a-library) both libraries to your Figma workspace.
2. Wait for all components to finish publishing.
3. Reload both files.

#### Step 3: Add a new component

1. Add the variables related to the new component to your existing library.
2. Copy the new component from the latest UI kit.
3. Paste it into your project file.

#### Step 4: Swap libraries

1. In your library, locate the "Assets" button (book icon).
2. Find and open the latest shadcn/ui kit under "Libraries used in this file".
3. Click "Swap library".
4. In the [Swap library](https://help.figma.com/hc/en-us/articles/4404856784663-Swap-style-and-component-libraries) window, choose your custom library.
5. Review the list of styles and components to be replaced.
6. Click "Swap Library" to apply.

#### Step 5: Use the Swap Variables plugin

1. Open the [Swap Variables](https://www.figma.com/community/plugin/1349108836145173291/swap-variables) plugin.
2. Select the newly added component in your project.
3. Choose "Local Variables".
4. Click "Swap Variables".

#### Step 6: Verify changes

Switch between light and dark [modes](https://help.figma.com/hc/en-us/articles/15343816063383-Modes-for-variables) on the new component. Confirm it uses your custom styling, including correct backgrounds for elements like input fields.

If some variables or components didn't swap, manually [swap those instances](https://help.figma.com/hc/en-us/articles/360039150413-Swap-components-and-instances) with ones from your file.
