For the complete documentation index, see llms.txt. This page is also available as Markdown.

Status and People Field Fidelity

Make Notion Status and People properties look and behave correctly in your published app — colored status chips, people name chips, multi-select people defaults, and reliable writeback to Notion.

What changed NotionApps now preserves Notion Status option colors in list tags and Details chips, shows People as chips (avatar when available), defaults new People create/update fields to multi-select, and keeps Owner / People edits writing back to Notion.


What you get

Surface
Before
After

List tags for Status

Often flat / app-default colors

Notion option colors (Open = green, Scouting = blue, Closed = red, …)

Details Status

Plain text or weak chip

Colored status chip matching Notion

Details People / Owner

Easy to miss as plain text

Name chips (with avatar when Notion provides one)

Create / Update People fields

Often single-select by default

Multi-select by default for People-like fields

Editing Owner in the app

Could look saved without Notion updating

Values write back to the Notion People property

Restaurants builder ready with Status and Owner fields connected

Before you start

You need:

  • A Notion database with a Status property and/or a People property

  • Those properties linked into your NotionApps screens (List, Details, Create Form, Update Form)

  • Permission to Reload Data and Publish


Step 1 — Confirm Status colors on a List screen

  1. Open your app in the builder.

  2. Select a List screen that shows a Status property (for example, Restaurants).

  3. In preview, open the list and confirm status tags use Notion colors — not a single flat accent for every option.

List screen showing Status tags with Notion option colors

What to expect

Status example
Typical Notion color

Open

Green

Scouting / In progress

Blue

Closed / Done

Red / gray depending on your Notion options

Not started

Default / gray

If colors look wrong after a Notion change, click Reload Data, then re-check the list preview.


Step 2 — Confirm Status + People chips on Details

  1. Open a Details screen for the same database.

  2. Select a record that has both Status and Owner (People) filled.

  3. Confirm:

    • Status renders as a colored chip

    • Owner renders as a people chip (name, and avatar when available)

Details screen with green Open status chip and Owner people chip

Compare another status value to verify colors track the option, not a single hard-coded color:

Details screen with blue Scouting status chip

Step 3 — Edit People / Owner and verify Notion writeback

  1. Open a Create Form or Update Form that includes the Owner / People field (People defaults to multi-select).

  2. Choose or change the selected person (add or replace).

  3. Submit / save.

  4. Confirm the Owner chip on Details (and in Notion) matches what you saved.

Create form with Owner people field (multi-select) ready to edit
Details showing Owner people chip after save / writeback

Step 4 — Create Form People defaults

When you add a new People create/update field in the builder, NotionApps now defaults it to multi-select behavior so makers can assign more than one person without hunting for a setting.

Recommended check:

  1. Add or select a People field on a Create Form.

  2. Confirm users can pick multiple people when that matches your Notion property.

  3. Publish and test on the live app.


Checklist


Troubleshooting

Symptom
Likely cause
What to do

Status tags all the same color

List tag colors not refreshed from Notion

Reload Data; for brand-new lists, recreate the list screen or re-seed tag colors

Status chip missing on Details

Field not mapped / wrong component

Confirm the Details component is bound to the Status property

People shows email only / no chip

Older layout cache

Reload Data, hard-refresh preview, republish

Notion People still empty after save

Pending sync or wrong property

Wait a few seconds, refresh Notion, confirm the form field maps to the People property

Single person only on Create Form

Field still configured as single-select

Open the field Behaviour and allow multi-select for People