Appearance

Table Display Configuration ​

Table Configuration > Table Display Configuration

Control how your tables and records appear throughout your platform with two simple settings: table names and record identification.

What is Table Display Configuration? ​

Table Display Configuration lets you:

  • Rename tables - Change "user" to "Team Members" in navigation and forms
  • Choose how records appear - Show "John Smith" instead of "USR100000" in dropdowns
  • Create professional interfaces - Match your business terminology across the platform

Two Key Settings ​

Display Names ​

Changes how your table appears everywhere - navigation menus, page titles, breadcrumbs, and forms.

Display Fields ​

Chooses which field represents records in lists, dropdowns, and relationships.

Default priority: Display Field → title → display_name → name → ID

How to Configure Table Display ​

Changing Table Names ​

  1. Go to Settings → Tables
  2. Find your table and click to open it
  3. Update the Display Name field
  4. Save changes

The new name appears immediately in navigation, forms, and page titles.

Setting Display Fields ​

  1. Go to Settings → Tables
  2. Open your table record
  3. Choose a Display Field from the dropdown
  4. Save changes

Records now show values from your selected field instead of IDs.

Choose fields that help users identify records:

  • ✅ Name, title, email, company name
  • ✅ Business identifiers (product codes, customer numbers)
  • ❌ IDs, true/false values, long descriptions

Tip: If your ideal display field doesn't exist, you can create computed fields using Record Behaviors, then configure their display names and descriptions in Field Configuration.

Examples ​

Team Members Table ​

Before: "user" table, records show as "USR100000" After: "Team Members" table, records show as "john.doe@company.com"

Product Catalog ​

Before: "product" table, records show as "PROD1000000" After: "Product Catalog" table, records show as "Wireless Bluetooth Headphones"

Customer Management ​

Before: "customer" table, records show as "CUST100000" After: "Customers" table, records show as "Acme Corporation"

Best Practices ​

Table Names: Use clear, professional language that matches your business context. Avoid technical jargon.

Display Fields: Choose fields that help users immediately identify records. Prioritize uniqueness and meaningful information.

Common Questions ​

Can I combine multiple fields for display? Yes! Create a Record Behavior to compute a field that combines values (like "First Name + Last Name"), then set that as your display field.

What if my display field is empty? The system falls back to: title → display_name → name → ID.

Do changes affect my data? No, only the interface changes. Your actual data stays the same.

Next Steps ​

Now that you've configured how your tables and records appear, consider these related configuration areas:

Take your table customization further with these advanced features:

  • Custom Views - Add custom buttons and actions to your tables for enhanced functionality
  • Smart Input - Use AI to help create records faster and more accurately
  • View Actions - Design effective action buttons for your custom views

Back to Overview ​

Return to Table Configuration for a complete overview of all configuration options.