# Sync a color palette to the local library

{% stepper %}
{% step %}

### <i class="fa-lock">:lock:</i> Sync to the local styles

The shades/tints are grouped by source colors, from the darkest to the lightest. If any `Color modes` have been created, the groups will be gathered and named with their related color mode. In addition, if the palette has a custom name, every group is gathered into one with the palette name.

Once the palette is ready, click the `Sync with the local styles` button to add every color shade/tint to the document's local styles. These styles can be published as Team Library.

The description of the `Source colors` is reworked and added to the description of the local styles.

If you update the palette after adding its shades/tints to the local styles, you can click the `Sync with the local styles` button to update the styles that have been edited. The synchronization is not on both sides because you cannot update your palette from the local styles.

{% hint style="info" %}
The synchronization with the local styles is not deep by default, so the styles that do not match the shade/tint of your palette will remain. Read more about the [`Preferences`](https://docs.ui-color-palette.com/user-management/update-your-preferences).
{% endhint %}
{% endstep %}

{% step %}

### <i class="fa-lock">:lock:</i> Sync to the local variables

Once the palette is ready, click the `Sync with the local variables` button to add every color shade/tint into the document's local variable. These variables can be published as Team Library.

A new collection with the palette's name and a default mode named `Value` is created, and the shades/tints are pushed from the darkest to the lightest and grouped by source colors. If any `Color modes` have been created, they are pushed as variable modes, and the empty cells are filled with shade/tint [`RGB`](https://docs.ui-color-palette.com/glossary#rgb) values.

The description of the `Source colors` is reworked and added to the description of the local variables.

{% hint style="warning" %}
According to your Figma plan:

* In Figma Starter, you cannot add more than 1 variable mode.
* In Figma Professional and Organization, you cannot add more than 10 variable modes.

Learn more by consulting [Figma pricing](https://www.figma.com/pricing/).
{% endhint %}

Suppose you update the palette after adding its shades/tints to the local variables, you can click the `Sync with the local variables` button to update the variables that have been edited. The synchronization is not on both sides because you cannot update your palette from the local variables.

{% hint style="info" %}
The synchronization with the local variables is not deep by default, so the variables that do not match the shade/tint of your palette will remain. Read more about the [`Preferences`](https://docs.ui-color-palette.com/user-management/update-your-preferences).
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

```
GET https://docs.ui-color-palette.com/guides/sync-a-color-palette-to-the-local-library.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.