# Custom properties We cover in this page **how to use, create and manage custom properties in Rayon.** ### What is a custom property? Offering **custom properties** is Rayon's way of **allowing users to add data to their drawing**. This information can be added onto **`models`**, **`zones`**, **`walls`**, **`blocks`** (instances and definitions), **`shapes`**, **`layers`**, **`styles`**, and **`pages`**, and later be **retrieved, listed, and formatted in tables.** In Rayon's editor, **custom properties can be found in the `custom properties` section**, whenever some entities are selected.

### Creating a custom property Let's start by c**reating a new custom property.** \ With an entity selected, click on the **`Add property`** button. Then, click on the **`+`** button, in the header of the panel. This will allow you to **create a new property** that will be applied to the current selection.

You will now have to specify the **`name`**, **`format`**, **`type`** and **`value`** of the new property you are about to create. The property **`format`** expresses the kind of thing the property documents (a price, a name, a length, etc). In Rayon, available formats are: * Text * Length (in model units) * Area (in model units) * Volume (in model units) * Number * Price (in model units) * URL * Boolean * Image The **`type`**, then, allows you to choose whether the property should be a... * Single value * List of values (category single or multi) * Formula (a value computed dynamically, based on other properties) Clicking on **`Save`** will confirm the creation of the property and apply it to the current selected entity(ies).

### Applying custom properties Any existing custom property, present in the panel, can be **applied to the selection** by simply ticking its checkbox.

### Managing custom properties At any point, custom properties present in a model can be managed from the left side of the screen. The **`Custom properties`** panel stores all existing properties added by you or other users at any point. From there, custom properties can be... * Searched * Created (from the **`New property`** drop down) * Edited (name and default value(s))

### Inheritance Another useful feature of custom properties is **inheritance**. In other words, the custom properties carried at one level can be transmitted to a lower level. For instance: * **`Definition`** → **`Instance`** : A property carried by a block definition will also be carried by its instances. * **`Style`** → **`Entity`** : A property carried by a style will also be carried by entities carrying that style. At any point, an inherited property can be overridden; for instance, the value of a property inherited by an instance from its definition can be changed to a different, specific value. The value can then we set back to its initial value, by clicking on the reset icon present on the property value field. ### Tutorial For more step-by-step information, watch our tutorial about how to use tables and metadata in Rayon. {% embed url="" %} *** ### 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](/other-resources/others/support.md). --- # 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.rayon.design/documentation/layout-and-present/custom-properties.md?ask= ``` 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.