> For the complete documentation index, see [llms.txt](https://docs.rayon.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rayon.design/documentation/design/styles.md).

# Styles

Controlling your drawing's aesthetics.

Rayon is also about **applying a professional rendering to your drawings**: applying colors, strokes, fonts, text sizes, using hatches and textures, etc.

**All this** can be controlled in Rayon **using** **styles**, edited in the properties panel on the right and listed in the **`Styles`** panel on the left.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FXVjUZX5WXNjj9DbKSD2i%2Fstyles-panel-overview.png?alt=media" alt=""><figcaption></figcaption></figure>

### The basics of styles <a href="#h_c0d5ad3f27" id="h_c0d5ad3f27"></a>

In Rayon, **styles define how all elements look** (a text box, a line, a surface, etc.).

#### Style types

Styles come in 5 different types: **shape** style, **text** style, **annotation** style, **wall** style and **solid** style. We detail below how each style type works...

{% tabs %}
{% tab title="Shape style" %}
**Shape styles** offer the following options:

* Fill (type, opacity, etc.)
* Stroke (weight, color, dashing, etc.)

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2F0MduiIIdEaKwA77edatj%2Fstyles-type-shape.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Text style" %}
**Text styles** offer the following options:

* Text color and size (type, opacity, etc.), and text options (units, unit formatting, etc.)
* Font family
* Font style (bold, italic, etc.)
* Line height, background and border, through **`Add options`**

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FTytPJrxiOVCbKua7x4BR%2Fstyles-type-text.png?alt=media" alt=""><figcaption></figcaption></figure>

**Text options** allow you to further customize your text's content. The **...** button next to the text size opens **`Units and precision`**.
{% endtab %}

{% tab title="Annotation style" %}
**Annotation styles** offer the following options:

* Text color and size (type, opacity, etc.), and text options (units, unit formatting, etc.)
* Font family
* Font style (bold, italic, etc.)
* Stroke (weight, color, dashing, etc.)
* Extension lines option (weight, color, dashing, etc.)
* Ends styling (arrowhead, dot, etc.) and size
* Head options (block vs text)
* Background and border, through **`Add options`**

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FPm9HbyZ8uPaZL1Q4AUH9%2Fstyles-type-annotation.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Wall style" %}
**Wall styles** offer the following options:

* Thickness
* Fill (type, opacity, etc.)
* Stroke (weight, color, dashing, etc.)

In a model with a 3D canvas, a **`2D`** and **`3D`** toggle sits under the thickness in the style's **`Edit style`** popover. In the properties panel, it shows on a 3D canvas, and on a **`Level`** or **`Section`** canvas for walls that come from your 3D model. The two sides hold:

* In **`2D`**: the fill and stroke above, plus **`Face Fill`** and **`Face stroke`**: how the wall is drawn where it is seen but not cut, on a **`Level`** or **`Section`** canvas. In the properties panel, these four rows read **`Face fill`**, **`Face stroke`**, **`Cut fill`** and **`Cut stroke`**.
* In **`3D`**: **`Fill`**, the wall's look in 3D: a solid color, a texture or an image

Slabs use wall styles too. A slab takes its thickness and its look from its style.
{% endtab %}

{% tab title="Solid style" %}
**Solid styles** offer the following options, split by a **`2D`** and **`3D`** toggle:

* In **`3D`**: **`Fill`**, the solid's look in 3D: a solid color, a texture or an image
* In **`2D`**: **`Fill`** and **`Stroke`**, where the solid is seen on a **`Level`** or **`Section`** canvas
* In **`2D`**: **`Cut fill`** and **`Cut stroke`**, where the solid is cut

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FkCJKy1llqpIYZXxtrmMj%2Fstyles-solid-style.png?alt=media" alt="The Edit style popover for a solid style, set to 2D, with the Fill, Stroke, Cut fill and Cut stroke rows."><figcaption></figcaption></figure>

More [about styling in 3D here](https://docs.rayon.design/documentation/work-in-3d/styling-in-3d.md).
{% endtab %}
{% endtabs %}

#### Fill types <a href="#h_aeea2b7ec7" id="h_aeea2b7ec7"></a>

In shape and wall styles, the **fill option** can be of different kinds: **solid**, **gradient**, **texture** and **hatch**. Shape styles add **image**. We detail below how each one works.

To change a fill, select the object and click its **`Fill`** in the properties panel: the **`Edit fill`** popover opens beside the panel, with one tab for each fill type.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FAN6A7onQusU4veeE8212%2Fstyles-fill-in-panel.png?alt=media" alt="The properties panel of a selected shape, with its Fill row on Solid and the Edit fill popover open beside the panel."><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Solid" %}
Fills can use a **`Solid`** fill.\
A solid fill is made of a single color and an opacity.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FKDN8MNzrbeRJ8T62x3IG%2Fstyles-fill-solid.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Gradients" %}
Fills can use a **`Gradient`**.\
Gradients can be **`Linear`**, **`Angular`** or **`Radial`**.

For any of those options, controls will be accessible on the canvas to define the position and extents of the gradient. **`Start`** and **`End`** values will allow you to assign a given color to each part of the gradient.
{% endtab %}

{% tab title="Texture & hatches" %}
Fills can use a **`Texture`** or a **`Hatch`**.\
Both types of fill allow **choosing a pattern**. If patterns offered in Rayon's libraries are not what you need, **uploading** a seamless texture or a PAT hatch file is also possible.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FW3VmofuhMB2rReMAYhBk%2Fstyles-fill-texture-hatch.png?alt=media" alt="The Edit fill popover on the Hatch tab, with the Texture and Hatch tabs marked."><figcaption></figcaption></figure>

For entities carrying a fill using a **hatch** or a **texture**, **the pattern of each element can be edited independently!** To do so, head to the **`Tiling`** section and click **`Add tiling`**.

{% embed url="<https://player.vimeo.com/video/1247583473?autoplay=1&controls=0&loop=1&muted=1>" %}

You can then click the pencil next to **`Settings`** to edit on the canvas: **drag the blue dot to offset** the pattern and **the blue arrow to rotate** it. Or **simply input precise offset/rotation values** in the **`Edit tiling`** popover, which opens when you click the values next to **`Settings`**.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2F4vM1q03MyAcECVOO0jyx%2Fstyles-fill-tiling.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Editing, saving & sharing styles

Styles can be either **specific** to a given entity, or **shared** across elements.

Styles can be **edited**, **published**, and **shared** across your drawings.

Let's dive in!

#### Editing a style <a href="#h_f70982897a" id="h_f70982897a"></a>

**Styles' settings** can be found **in the properties panel**, on the right.\
Styles can be edited through their **different fields** (Fill, Stroke, etc.), or **swapped**/**saved** through the options of the section header.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FCndFx6EU2EnEHxlDRJsP%2Fstyles-section-header.png?alt=media" alt="The Styles header in the properties panel for a selected shape, with its Pick style, Save style and Select style buttons above the Fill and Stroke rows."><figcaption></figcaption></figure>

**`Pick style`** (`SHIFT + S`), the eyedropper in the same header, copies a style from the canvas. Click it, then click a similar element: your selection takes that element's style.

#### Saved styles

At any point, **the style of an element can be saved**, in order to apply it to multiple elements at once. To save it, click **`+`** in the style's section header.

Once saved, a style displays different options...

* Editing
* Swapping
* Detaching

... accessible on and above the style itself.

**`Edit style`** and **`Detach style`** only show when you hover over the style. **`Select style`** (the four-dot icon) and **`Detach all`** (the link icon) stay in the header above it.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FoHtZMW0QxxWEdAwROCXP%2Fstyles-saved-style-row.png?alt=media" alt="A saved style in the properties panel, hovered so its Detach style and Edit style buttons show, under a header with Detach all and Select style."><figcaption></figcaption></figure>

**Editing** a saved style changes that style across all elements carrying it.\
That way, an entire drawing can be redesigned **by simply editing the few saved styles** carried by the drawing's elements.

{% embed url="<https://player.vimeo.com/video/1246533765?autoplay=1&controls=0&loop=1&muted=1>" %}

The **`Edit style`** popover also has a **`Style properties`** section, for custom properties on the style. More [about custom properties here](https://docs.rayon.design/documentation/layout-and-present/custom-properties.md).

**Swapping** replaces a saved style with another.\
That action can be triggered by using the **`Select style`** button, or by **clicking on the style itself.**

**Finally, detaching** removes a saved style from the current selection. Elements whose style has been detached will go back to having their own specific styling. **`Detach all`**, in the header, detaches every saved style in the selection.

### Layer-level styling <a href="#h_layer_level_styling" id="h_layer_level_styling"></a>

Beyond styles, **a layer can carry style values of its own**, which the elements sitting on it can pick up. Change a value on the layer, and **every element inheriting it updates at once.**

#### Setting values on a layer

Select a layer, and head to the **`Inheritable values`** section of the properties panel.\
Five values can be set there: **`Color`**, **`Opacity`**, **`Stroke weight`**, **`Dash pattern`** and **`Dash scale`**.

{% hint style="info" %}
These are not the **`Layer color`** and **`Layer opacity`** sitting above them. **`Layer color`** identifies the layer in the **`Layers`** panel and drives wireframe mode. **`Layer opacity`** sets the base opacity of the elements on the layer. More [about layers here](https://docs.rayon.design/documentation/design/layers.md).
{% endhint %}

#### Inheriting a value

In an element's **`Fill`** or **`Stroke`** options, **hovering over a value reveals a layer icon** on its right. Clicking it makes that value **come from the layer** instead of the element.

![The Edit fill options, with the layer icon at the right of the Hex field](https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FfUs1oxsEbreDpjh1Do5S%2FInherit_from_layer.png?alt=media)

The field then shows the layer's value and can no longer be edited; **to change it, change it on the layer.** Clicking the icon again gives the element its own value back. Picking a color in the picker, from the recent colors or with the eyedropper does the same.

{% embed url="<https://player.vimeo.com/video/1246533771?autoplay=1&controls=0&loop=1&muted=1>" %}

Values are inherited **one by one**, and only **solid color fills** can inherit. When you select several elements and only some of them inherit, the layer icon shows a third, mixed state.

Shapes and walls can inherit their stroke and fill values, text elements their color and opacity, and annotations their stroke values plus their text color and opacity.

### Style libraries & publishing <a href="#h_aeea2b7ec7" id="h_aeea2b7ec7"></a>

At any point, you can **find all the styles contained in your drawing** in the **`Styles`** panel on the left.

* **`My styles`** lists all the styles you have in your model
* **`Libraries`** gives you access to extensive libraries

Styles listed under **`My styles`** can be **curated**, using the panel's options; actions such as...

* **Creating** new styles by clicking on **`+`**, then choosing a type
* **Editing/renaming** any given style
* **Deleting** unused styles
* **Merging** similar styles, with **`Merge similar styles`** in the **...** menu

Right-click a style for **`Duplicate`** and, when the style is in use, **`Select all`**, which selects everything using it. The **...** menu also holds **`Delete unused styles`**, and switches the list between **`List`** and **`Cards`**.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FNElwi03YbvEAX4ZNtvp7%2Fstyles-panel-publish.png?alt=media" alt="The style panel on the My styles tab, with the Libraries tab beside it and the Publish button next to the search field."><figcaption></figcaption></figure>

More importantly, this list can be **turned into a library**, by being published.

* Publishing starts from the **`Publish`** button, next to the search field in **`My styles`**. It opens the **`Publish styles`** dialog.
* In the dialog, you can search your styles, and switch each style or a whole type on or off. **`Publish # styles`** publishes the ones left on.
* A library can be **updated** at any time by reopening the dialog and hitting **`Update # styles`**. **`Unpublish`** takes it down.
* Who can use a published library depends on where the model lives: you only, your team, or members of the workspace. The info icon in the dialog tells you which.

You need to be the model owner or an admin, and have at least one saved style, to see the **`Publish`** button.

To organize your styles, blocks and layers in one shared model, read our page about [design standards](https://docs.rayon.design/documentation/publishing-and-sharing/design-standards.md).

More [on libraries here](https://docs.rayon.design/documentation/publishing-and-sharing/publishing-a-library.md).

#### Using a library style

In **`Libraries`**, pick a library and filter by type if you need to. Click a style to preview it, then hit **`Import`**. With a library picked, **`Import the whole library`** in the **...** menu brings in all of its styles.

An imported style stays linked to its library. Its **`Edit style`** popover shows the link in a **`Style source`** section, with **`From`**, and **`Version`** when the library records one.

* **`Update from library`** moves the style to the library's latest version. Rayon asks you to confirm first.
* **`Detach from library`** turns the style into a local copy, which library updates no longer touch.

Both actions are in the style's right-click menu in **`My styles`**. The **`Style source`** section also has them, as **`Detach from library`** and **`Update to latest version`**.

### The ***active*** style

Each time a creation command is used, the **active style appears in the properties panel**; that style will be **assigned to the things you draw** with the current command.

***

### We are always available

Book a demo with our team, [right here](https://b1kzip68v9f.typeform.com/to/Hgr0eQ4k#source=docs).\
To get some support, reach out to us through our **in-app support chat**.\
More about [our support policy right here](https://docs.rayon.design/other-resources/others/support-policy.md).
