Tables

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

Open the Data panel

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

Click New table

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

Name your table

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

Choose a permission model

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

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.

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.

Admin

Only you can create and manage entries, while everyone can view them.Ideal for delivering content such as news, blog posts, or products.

Private

Users privately create, view, and manage their own entries.Works well for personal data such as tasks, personal notes, or habit trackers.

Shared

Users create and manage their own entries while everyone can view them.Great for community-driven content like forums or recipe sharing.

Public

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

Type	Use for
Text	Names, descriptions, labels, URLs, and other freeform strings.
Rich text	Long-form content with formatting — headings, bold, links, lists.
Date	A date or date-and-time value. Rey renders a date picker.
True / false	Boolean flags like `Is active`, `Completed`, or `In stock`.
Multiple choice	A fixed set of options (e.g., `Draft`, `Published`, `Archived`).
Number	Integers and decimals — prices, counts, ratings.
Image	An uploaded image. Bind to an Image component to render it.
Audio	An uploaded audio file. Bind to an audio player component.
Relation	A 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.

Get Started

Building Your App

Rey AI

Publishing

Integrations [WIP]

Account & Billing

Create a new table

Permissions

Field types

Edit a table later

​Create a new table

​Permissions

​Field types

​Edit a table later

Create a new table

Permissions

Field types

Edit a table later