Mmatte/docsBack to Matte

Objects and fields

Create lists, choose field types, connect records, and control who can see sensitive values.

Objects define what your workspace tracks. Fields define what you know about each record. Use built-in app objects where they fit, and add custom objects or fields for the details unique to your team.

Create and organize a list

Open Workspace Settings → Data Model to see the Object Directory and the Data Visualizer. The directory opens each object’s settings and controls whether supported record objects appear in navigation. The visualizer helps you inspect objects, fields, and their relationships.

Choose New Object to create a custom list. Set its singular and plural names, icon, description, and primary label field. A clear primary label makes records easier to identify in search results and relationship pickers.

An object’s settings are organized into General, Organization, Fields, Views, Detail panel, Activity, and Permissions. General includes its names, description, page address, and record label. Organization controls supported folder behavior. Built-in objects can reserve fields or settings that the app needs for its workflows.

Choose the right field type

  • Everyday values. Text, Number, True/False, Date, Date and Time, Currency, Rating, and Icon cover names, measurements, flags, dates, money, and visual labels.
  • Choices. Select stores one choice. Multi-select stores several. Configure the options and their presentation so the team uses a consistent vocabulary.
  • Contact details. Emails, Phones, Links, Full Name, and Address keep related parts together instead of spreading them across unrelated text fields.
  • People and progress. Person and People identify workspace members. Progress stores current and total values. Map Location stores location details.
  • Longer or structured information. Rich Text supports formatted content. JSON and Array are available when you need structured values.
  • Connections and calculations. Link to another list connects records in different objects. Calculated Field derives an output from a formula.

Add a field

A required field must have a value before a record can be saved. Unique fields reject duplicate values. Uniqueness is available for suitable single-value fields; it does not apply to every multi-value or structured type.

Defaults help populate new records. Changing a default is not the same as replacing values already saved in existing records. Likewise, hiding a column in one view does not delete the field or its data.

  1. Open the object’s settings and choose Fields, then New field. The table’s add-column menu also offers New field if you have permission.
  2. Enter the field name, choose its type and icon, and add a helpful description or hint.
  3. Configure the options that apply to that type, such as select choices, a date display, progress labels, or a default value.
  4. Decide whether the field is required and, for supported scalar types, whether values must be unique.
  5. Create the field and check it in a real record and in the views where your team needs it.

Connect records instead of copying details

Use New relation or Link to another list to connect records. Choose the target object and the supported relationship type. For example, an item can point to a supplier, or an opportunity can point to a company.

Relationship settings can choose which fields form the displayed label, which extra details appear in a picker, and which fields users can search. These settings help distinguish records with similar names.

Relations keep a link to the original record. Copying a supplier name into a text field creates a separate value that will not behave like a relationship. Keep this distinction in mind when mapping imported columns.

Use calculated values

When creating a Calculated Field, choose the output type and supply its formula. Supported output choices include Number, Currency, Text, and True/False. The result is computed from the formula rather than entered as a normal editable value.

Use the field names and formula syntax accepted by Matte. Calculated fields are not a full spreadsheet application, and a spreadsheet formula should not be assumed to work unchanged. Check a few known records after creating a calculation so the result matches the meaning you intended.

Control access to fields

Who can see this field lists the object’s permission roles. An authorized administrator can untick roles to hide a restrictable field from those users. Owners always retain access. Field permissions depend on the workspace’s plan and your permission to manage object access.

Restricted values remain protected in tables, boards, record panels, search, exports, activity, APIs, and agent work. Someone who cannot read a field cannot use a hidden value by copying it, filtering by it, or sorting by it.

Display configuration and access control solve different problems. Hide an unneeded column to simplify a view; restrict a field when its contents should not be available to a role.

Related guides

Something unclear?Send feedback ↗

Search all guides.

Getting startedStart here · Set up a workspace, choose your apps, add data, and find your way around Matte.What you can do in MatteStart here · Find the shared workspace tools and the app guides that explain them.Apps and your workspaceStart here · Understand what apps add and how they fit into a shared workspace.Objects and fieldsData & views · Create lists, choose field types, connect records, and control who can see sensitive values.Records and detail pagesData & views · Create and edit records, organize their detail panels, work in bulk, and recover deleted data.Views, filters, and searchData & views · Turn the same records into useful tables, boards, calendars, and tiles, then find what you need.Importing and exporting dataData & views · Bring in spreadsheets, match columns, review problems, and export selected records or a complete view.Team chatCollaboration · Keep conversations, files, decisions, and follow-ups together in channels and direct messages.Channel settings and permissionsCollaboration · Choose who joins a channel, what members can do, and how long chat history is kept.CalendarCollaboration · See events, time off, agent work, counts, deliveries, and shipments in one place.Notifications and activityCollaboration · Find work that needs attention, follow mentions, and review what happened to a record or conversation.Talk to agentsAgents · Ask questions, give agents work, review proposed changes, and keep the results with your conversation.Agents and scheduled tasksAgents · Set up agent profiles, permissions, memory, spending, and recurring work.Workspace and teamWorkspace · Invite people, organize departments, manage roles, and configure your shared workspace.Account and workspace securityWorkspace · Manage passwords, passkeys, two-factor authentication, sessions, and account access.Plans, billing, and AI creditsWorkspace · Understand workspace capacity, seats, trials, shared AI credits, and agent spending limits.Preferences and keyboard shortcutsWorkspace · Adjust your profile, appearance, accessibility, date preferences, and keyboard controls.API, CLI, and MCPDevelopers · Connect authorized developer tools to Matte’s action API and discover their available capabilities.How inventory worksInventory Tracking · Understand items, stock, locations, units, and the daily inventory workflow.Items and units of measurementInventory Tracking · Build a clear item catalog and count or order in the units your team uses.Stock, locations, and transfersInventory Tracking · Add, correct, remove, and move physical stock with a useful history.Expiration dates and lotsInventory Tracking · Track batches, spot expiring stock, and record waste without losing the rest of an item's inventory.Barcode scanning and labelsInventory Tracking · Find an item with your camera or a typed code, adjust stock where allowed, and print unit labels.Inventory countsInventory Tracking · Assign, complete, review, and repeat counts without treating blank rows as zero.Purchase orders and receivingInventory Tracking · Create supplier orders, track expected deliveries, and receive accepted stock into the right location.Suppliers and replenishmentInventory Tracking · Turn low-stock needs into supplier orders, reviewed emails, and repeatable ordering routines.Quotes, sales orders, and shippingInventory Tracking · Track customer commitments, partial shipments, payments, and printable sales documents.Inventory dashboards and reportsInventory Tracking · Build your Inventory Overview dashboard and explore stock value, usage, count accuracy, and forecasts.Demand forecastingInventory Tracking · Read predicted consumption, confidence, and forecast accuracy without confusing estimates with orders.TroubleshootingHelp · Work through common questions about access, data, conversations, and app workflows.
↑ ↓ to move · Enter to open · Esc to close