# Tables

**The properties that entities in your model carry can also be listed into tables** (both regular properties and custom ones). **To that end, the `Tables`** panel can be found on the left in the edito&#x72;**.** Tables created in the panel can be inserted on the canvas and will stay linked to their source, keeping your canvas output in sync with your data.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FR0ppKGFewF0gVMAwomix%2FVincent-F-18%20(2).png?alt=media&#x26;token=c51a330b-a11a-44c0-8348-a94414f2da74" alt=""><figcaption></figcaption></figure>

### **Creating a table**

To create a new table, click the **`+`** button. Once created, **a table can be displayed in full screen mode**, to allow for a smoother browsing experience. Note that the **table source dropdown**, in the table panel header, will define which canvas the table should consider listing.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FSn4OajUiZYOwxMGFSLTm%2FVincent-F-18.png?alt=media&#x26;token=0d922fd7-391d-48d0-9fcb-f7beeefb3d55" alt=""><figcaption></figcaption></figure>

### Curating a table

Inside the table panel, a table can then be curated to display various **entity types**, **properties**, and to display information using **grouping/sorting/filtering**.

#### Entity types & table source

Setting up a table begins with specifying a few key properties...

* **The table source**, which is the canvas that the table should consider to populate its rows. All canvas can be selected, the active one, or a specific canvas of your choosing.
* **The categories** of entities to list, or in other words, what types of things your table should contain (walls, zones, blocks, etc)

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2Fdd5MolaDB8gwRtKnrrhp%2FVincent-F-18%20(2).png?alt=media&#x26;token=1f7e2ee5-b9f6-41df-9f47-c16d8c40e619" alt=""><figcaption></figcaption></figure>

To narrow down further, you can draw a region filter directly on the canvas. This limits the table to only the entities within that area, useful when working with large drawings where you only need to\
list items in a specific zone.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FIejBwgcAzRi4mKMTVsRe%2FGeofilter.png?alt=media&#x26;token=bb9027cc-9e1f-4442-96bb-b0bd032b2f0c" alt=""><figcaption></figcaption></figure>

#### Adding properties

Click on the **`+`** button at the top-right of your table to add new properties to the table. You can drag and drop column headers to reorder them, and remove any column you no longer need.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FjnNQ6ftfrcIUGV20UaMR%2FVincent-F-18%20(4).png?alt=media&#x26;token=219a5a58-dfca-403e-9bbc-a3c2b2c36ba9" alt=""><figcaption></figcaption></figure>

#### Sorting & filtering

You may **sort** the table alphabetically **based on a given column**. You may **filter** each column to only **show the elements matching** a given **filter**.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FNfh0Lrz5qODlb6SLAPel%2FVincent-F-18%20(6).png?alt=media&#x26;token=6166eb18-5454-4975-b5c1-223329ee5ff4" alt=""><figcaption></figcaption></figure>

#### Grouping

You can also **arrange tables by group.** Groups can be based upon any given property.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FDIPPYcw3XZNrq7YuX2wu%2FVincent-F-18%20(8).png?alt=media&#x26;token=7ca17820-00cb-411b-be17-3e571098d8cd" alt=""><figcaption></figcaption></figure>

### Inserting a table <a href="#h_0b668c5c99" id="h_0b668c5c99"></a>

Once created inside the table panel, **a table can be inserted on the canvas**, by clicking on **`Insert`**. This will create a table object, that can then be resized, formatted, and restyled to match your presentation's design.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FDWth4tYjIU5FtTb2sSdJ%2FVincent-F-18%20(1).png?alt=media&#x26;token=a1f4b3cf-4a5e-49f2-9e4a-edb8d8dd6e83" alt=""><figcaption></figcaption></figure>

Alternatively, a table containing empty cells that can be edited manually, can be created directly on the canvas by using the Table **`TA`** tool.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FSJ4mgpKfBy6gKlmuO3o7%2FFrame%201793.png?alt=media&#x26;token=5b3c7b0e-f873-4f3a-9849-c3ea2025a250" alt=""><figcaption></figcaption></figure>

Inside the table command, **a table can either be created as `none`, or using an existing table as `source`.** To that effect, the **`source`** property can be found in the active properties of the table command. Note that if a table is empty, its row/column count can be edited. This option is, however, not available if a source table is set.

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

When your drawing or table settings change, use the **`sync`** button to update all linked canvas tables.

### Exporting a table <a href="#h_0b668c5c99" id="h_0b668c5c99"></a>

You may also export your tables at any time in **.csv** or **.xlsx** formats using the **Export option** of the table context menu.

<figure><img src="https://2112124689-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FngVHKyaUSSJPTFck3wkz%2Fuploads%2FZMZtn54BT3Rg72NIylLB%2FVincent-F-18%20(3).png?alt=media&#x26;token=c1210c6a-0915-42e8-891b-5313642e8edd" alt=""><figcaption></figcaption></figure>

### Tutorial

For more step-by-step information, watch our tutorial about how to use tables and metadata in Rayon.

{% embed url="<https://www.youtube.com/watch?v=2r2XTSwCSQc&list=PL2mYb69TvSpw4sO2nADaUQpYXbzMe_z59&index=15>" %}

***

### 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).
