> ## Documentation Index
> Fetch the complete documentation index at: https://magicpatterns.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Detaching Components

> Detach components from your Design System to create one-off customizations

## Detach Components Tutorial

<Note>
  Use the "detach components" option sparingly when you need one-off
  customizations that do not need to sync with the main design system.
</Note>

<iframe className="w-full aspect-video" src="https://www.youtube.com/embed/pIqxaHmNiaA?si=5TXG_O3OSd93Ye3V&start=245" title="How to detach" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen alt="How to detach" />

While we recommend editing components directly to keep your design system consistent, there may be cases where you want more flexibility. For those situations, you can enable a preference to automatically detach components when adding them from a library. This setting can be found under Settings > [Preferences](https://www.magicpatterns.com/settings#preferences) > Automatically Detach Components.

Detaching gives you a raw instance of the component, allowing the AI to modify specific parts. However, it also breaks the link to the original component, so updates to the library version will not carry over.

Think of your components as the "lego bricks" of your app. You might use detach when:

1. You want the AI to edit the component directly
2. You are ok with the component not syncing with the main design system
3. You need to link screens together in the canvas (components are not currently supported in prototyping mode)

In most instances, you likely might be better off editing the instance of the component directly.

<Frame>
  <img src="https://cdn.magicpatterns.com/uploads/cHKwWPTSREGFZUcMKAKGSW/CleanShot_2026-04-30_at_13.15.29.png" />
</Frame>
