Skip to main content
Tables are the containers for your app’s data. Each table stores entries (records) that share the same set of fields (typed columns). This page walks through creating one from scratch.

​
Create a new table

1

Open the Data panel

Click the database icon in the top toolbar to open the Data panel.
2

Click New table

At the bottom of the panel, click + New table. The New table dialog opens.
3

Name your table

Enter a descriptive name (e.g., Tasks, Products, Posts).
4

Choose a permission model

Pick one of the four permission modes (see Permissions below).
5

Add fields

Every table starts with a Name text field. Click Add field to add more, choose a type, and give each one a name.
6

Save

Click Save. Your table is created and available to bind to components.
New table dialog with name, permissioning, and fields

​
Permissions

Permissions control who can create, edit, and view entries at runtime in your live app. Pick the mode that matches how the data is meant to be used.
Only you can create and manage entries, while everyone can view them.Ideal for delivering content such as news, blog posts, or products.
Users privately create, view, and manage their own entries.Works well for personal data such as tasks, personal notes, or habit trackers.
Users create and manage their own entries while everyone can view them.Great for community-driven content like forums or recipe sharing.
Everyone can create, edit, and view any entry.Use this for open collaboration, such as brainstorming boards or shared to-do lists.

​
Field types

When you add a field, pick the type that matches the shape of the data. The type controls the input Rey renders in the data grid and what you can bind to on the canvas.
Field type dropdown showing Text, Rich text, Date, True/false, Multiple choice, Number, Image, Audio, Relation
TypeUse for
TextNames, descriptions, labels, URLs, and other freeform strings.
Rich textLong-form content with formatting — headings, bold, links, lists.
DateA date or date-and-time value. Rey renders a date picker.
True / falseBoolean flags like Is active, Completed, or In stock.
Multiple choiceA fixed set of options (e.g., Draft, Published, Archived).
NumberIntegers and decimals — prices, counts, ratings.
ImageAn uploaded image. Bind to an Image component to render it.
AudioAn uploaded audio file. Bind to an audio player component.
RelationA link to an entry in another table (e.g., each Order links to a Customer).

​
Edit a table later

You can rename a table, change its permissions, or add and remove fields at any time from the Data panel. Setup changes are promoted to the live app the next time you publish — see Data overview for how edit mode interacts with your published app.