A field type sets what a field holds, which settings it has and what Cargofy accepts in it. You pick the type in “Type” when you add a field — see Set up fields.
Every type can also be marked Required — a record is not saved while the field is empty — and Primary (display) field — the value names the record.
Types at a glance
| Type | Holds | Settings | In the list |
|---|---|---|---|
| “Text” | Words and numbers as text | “Max length”, “Multiline” | the text |
| “Number” | A number | “Min”, “Max” | the number |
| “Date” | A date, or a date and time | “With time” | the date |
| “Yes / No” | Yes or no | — | “✓” or “—” |
| “Single select” | One option of a list | “Options”, “Depends on field” | the option |
| “Multi select” | Several options of a list | “Options”, “Depends on field” | the options, comma-separated |
| “Member” | A member of your company | — | the name |
| “JSON” | Structured data | — | the raw text |
| “Location” | An address with map coordinates | “Geocode address to coordinates” | the address |
| “File” | One or more files | “Allowed extensions”, “Max files”, “Max size (KB)” | the file names |
Types
Text
Names, routes, codes, comments.
- Settings: “Max length” — the longest text accepted. “Multiline” — a large box instead of one line in the record form.
- Accepts: any text up to the length you set.
- Search: “Search” in the records list looks inside text fields.
Number
Weight, rates, counts.
- Settings: “Min” and “Max” — the lowest and highest number accepted, both included. Leave one empty for no limit.
- Accepts: a number in the range. A value out of the range is not saved.
- Search: “Search” also looks inside number fields.
Date
Loading dates, deadlines.
- Settings: “With time” — the record form asks for a time too.
- Accepts: a date; with “With time”, a date and time. The list shows a date as
YYYY-MM-DD.
Yes / No
Flags such as “Active” or “Paid”.
- Settings: none.
- In the form: a switch.
Single select
Body type, status, country — one value of a fixed list.
- Settings: “Options” — each option has a “Label” your team sees and a “Value” that workflows and outside systems use; the value fills in from the label. Add option adds one more. “Depends on field” — show only the options that fit another select field, see Show options that depend on another field.
- Accepts: one value of the options.
Multi select
Several values of a fixed list, such as the countries a carrier serves.
- Settings: the same as “Single select”.
- Accepts: a list of values of the options.
Member
The person responsible for a record.
- Settings: none.
- Accepts: a member of your company. The form lists your company's members.
JSON
Structured data that a workflow or an outside system writes and reads.
- Settings: none.
- Accepts: a JSON object or list. In the form, text that is not valid JSON is not saved.
Location
Office, warehouse or loading address.
- Settings: “Geocode address to coordinates” — when a workflow, a Digital Worker or an outside system writes only the address, Cargofy adds the coordinates. Coordinates already given are kept.
- In the form: “Search address” — type at least three letters and pick the address; the coordinates come with it.
- Accepts: an address with latitude from -90 to 90 and longitude from -180 to 180.
File
Contracts, CMR scans, photos.
- Settings: “Allowed extensions” — type each extension and press Enter, for example
pdf. “Max files” — how many files the field holds. “Max size (KB)” — the largest file accepted. - In the form: Add files picks one or more files; a counter shows the files held out of the allowed number, and the button greys out at the limit.
- In the list: the file names; a click opens the file in a new tab.
- Note: removing a file from the field and saving the record deletes the file.