Data fields
Table of contents
Data fields represent the individual attributes of a data model. Each field stores a specific type of information with its own display rules and input controls. For example:
- A User model might include an
email(text),name(text),role(choice), and an optionalavatar(image). - An Apartment model might include a
title(text),location(location),rental-price(text/number),available_from(date), and a gallery ofphotos(images).
Doypp supports the following field types:
- Text
- Single-line text or multi-line text with line breaks
- Choice
- Predefined selection options (single choice or dropdown)
- Image
- Photos and graphic assets with automatic optimization
- Attachment
- Downloadable documents (PDF, Word, spreadsheets)
- Location
- Geographic coordinates with interactive map display
- Date & Time
- Calendar dates, clock times, or complete timestamps
- URL
- External web addresses with one-tap browsing
Text
The Text field is the most common data type. You can configure it as:
- Single-line text: Best for concise data such as names, titles, email addresses, phone numbers, or tags.
- Multi-line text: Best for longer narrative content like article bodies, product descriptions, feedback, and notes. It preserves paragraphs and line breaks.
Choice
The Choice field restricts input to a predefined list of values, preventing typos and ensuring data consistency. It is ideal for statuses, categories, priorities, or stages in a workflow.
When creating a Choice field, you define the list of valid options. Users can then select their choice using an intuitive mobile picker or dropdown.
Example: A “Defect” model uses a severity Choice field with values like Low, Medium, High, and Critical:
Image
The Image field allows users to attach photos either by taking a picture directly with their device camera or by selecting an existing file from local storage or cloud providers (such as Dropbox, Google Drive, or OneDrive).
Key features of the Image field include:
- Default Placeholder Image: You can provide a fallback image to display when a user has not uploaded their own photo (for example, a generic avatar or placeholder product image).
- Uniform Sizing: Define a standardized aspect ratio and display size so that images appear balanced and aligned across cards and list views.
Example: Setting a default avatar for user profiles:
Attachment
The Attachment field enables users to upload non-image files such as PDF documents, Word documents, spreadsheets, or archives. While attachments do not render an inline visual preview inside the view, Doypp automatically provides a convenient Download button that opens or saves the file on the user’s device.
Location / map
The Location field handles geographic data and renders interactive maps directly within your app.
Locations can be set in three ways:
- Direct Coordinates: Entering the latitude and longitude manually.
- Pin to Location: Navigating an interactive map and dropping a pin onto the desired spot.
- Use Current Location: Utilizing the device’s GPS to automatically capture the user’s current physical coordinates with a single tap.
Example: An apartment listing displaying the property’s geographic location on an embedded map:
Date & time
Doypp provides three distinct date and time field variations to suit different scheduling and record-keeping needs:
- Date: Captures calendar days without time-of-day information (e.g., birth dates, contract start dates).
- Time: Captures clock time without a specific date (e.g., daily opening hours, shift start times).
- Date & Time: Captures both a date and an exact timestamp (e.g., event scheduling, flight departures, reservation slots).
Each variation opens a native platform date or time picker for frictionless input.
URL
The URL field stores external web links (e.g., website addresses, documentation links, or external portfolios). When tapped by a user inside the application, the link opens seamlessly in their default web browser or in-app web view.
System Timestamps
In addition to custom fields, every data model automatically includes two built-in timestamp fields:
- Created at (
created_at): Automatically recorded when a record is initially created. - Updated at (
updated_at): Automatically updated whenever any field within the record is modified.
Both timestamps are system-managed, read-only, and provide an automatic audit trail for tracking data history and sorting chronologically.
Related Topics
- Configure validation and display rules in Data Properties.
- Connect models to each other in Data Relationships.