Open and Edit a Record
On this page
In the Web App, a record opens on its own form, where you review and change its fields, pick related records through lookups, and save your changes. For working with records in the Settings App, see Work in the Settings App.
Records in the Web App
What you can see and change
Without permission to edit a record, its whole form is read-only: every field is locked, and Save and the toolbar buttons that change the record are unavailable. See Permissions Reference.
A few record types work differently. Your right to edit Brand, Company Address, or Stock Room records is decided for the record type as a whole rather than per record, and Software Product records are always read-only on this form. Brand, Company Address, Software Product, and Stock Room forms have no Action Bar, so a Brand, Company Address, or Stock Room record is changed only by editing its fields and saving.
Even on a record you can edit, an individual field can still be locked by the field's own setting or by a record lock. These fields are always read-only on the form: a record's closure code, an asset's current value and last depreciation, a consumable's cost, an attachment's file size, a person's primary email, a project's planned effort, a software product's manufacturer, and the parent of a location, organization, project, or work order. A lease return date field is also read-only unless the form's Lease check box is ticked.
On a read-only form, most field values sit beside a caption; a yes/no value shows on its own with no caption, and multi-value, memo, rich-text, and image values appear in their own block instead. An encrypted value always shows as eight asterisks. Currency, reference, date, date-and-time, and duration values also have a read-only presentation of their own. Values of the remaining kinds, such as text, whole and decimal numbers, and IP addresses, show as plain text, as a link where the value carries one.
Open a record
Double-click a record's row in a list to open it. A double-click that lands on the row's check box or on a button in the row does not open the record. From a main list, the record opens over the list, so the list stays loaded behind it. It opens in a new browser tab instead when your personal setting to open records in a new tab is turned on (it is off by default), or when the list is a related-records panel. In a picker, a double-click picks the record instead of opening it; see Lookups and references below.
If you opened the record from a list, the toolbar shows Previous record and Next record, unless the record type hides them. They move the selection in the list to the row before or after the current one; they are unavailable at the first or last row of the list and while the form is saving. Moving to another record this way, or clicking Close, while the form has unsaved changes first asks whether you want to save them.
Closing a form that opened over a list returns you to the list exactly as it was, with the same rows, paging, and focused row.
Opening a record adds an entry for it to the breadcrumb trail, except for a Brand or Company Address record. A PO item's entry starts with its purchase order's number, and a contract's entry shows its contract number.
The toolbar of an open record has its own New button, followed by the record type's name. Its menu lists the create actions of the record's type, as a list's New menu does: while it loads, it shows a disabled "Loading...", and for a record type with no create actions a disabled "No Actions". On an Organization, Location, or Project, it also lists the create actions for records under the open one. An Approval Stage record has no New button. Work orders under a ticket or a work order are created with the New Work Order button of the record's Work Orders tab, and sub-tasks of a project task from its Sub-Tasks tab, not from this menu. Those tabs show their own New button only when the form is not read-only. A sub-task created from the Sub-Tasks tab opens with the open task already set as its parent.
The form's header can show the record's calculated fields and, on some record types, a lifecycle strip. On most record types, a Copy link to clipboard icon appears when you point to one header line, for an incident the line with its ticket number; an Invoice Item has none. Click the icon to copy a link to the record as both plain text and formatted text, captioned with the record's identifier, such as the ticket number. Hold Shift while clicking to add the text of the header's first field, such as an incident's summary, to the caption, unless that field is empty or the same as the identifier. The caption shows only when you paste into something that accepts formatted text, such as an email or a rich-text field; a plain-text destination gets the link's address either way. The link points to the record itself, so it keeps working after the record is renamed or renumbered.
A link to a record can also open it directly on one of its tabs, or on the tab that holds a particular field or activity entry, scrolled to it.
Validate and save your changes
A required field carries an asterisk, and the form does not save while one is empty, with the message "This field is required." An unchecked box or a zero counts as a value, a lookup counts as filled only when a record is picked, and a read-only field is not checked.
Save the record
- Change the fields you want to update. Save becomes available once you have changed something on the form.
- Click Save on the toolbar.
If the save returns messages, they are shown, nothing else happens, and Save becomes available again. Otherwise the form and its actions are reloaded, the tab counts, the Attachments tab, and the Related Objects tab are refreshed, and a list of the same record type open behind the form is reloaded. When the saved record carries a currency, every list on the record's form is also refreshed, even on tabs you have not opened, so money columns show the new currency. A successful save also rebuilds the calendar of a Reservations or Work Calendar tab and the Gantt view of a project's Tasks tab from scratch, so any change you made to how they are displayed is reset.
Leave a record with unsaved changes
If you leave the page entirely - reloading, closing the browser tab, or navigating elsewhere - while a record has unsaved changes, your browser asks you to confirm before you lose them.
If the record changes elsewhere
If someone else changes the record while you have it open, the form does not save over their change. While the browser tab is visible, the form checks for such changes about every 10 seconds and when you return to the tab. When it finds one, it shows a banner with a Reload button; if you also have unsaved changes, a prompt asks you to reload. The prompt has no other button and cannot be closed; after you click its reload button, your browser asks you to confirm leaving the page, and if you cancel there, the prompt closes and your typed values stay on the form. If you save after the record was changed or removed elsewhere, the save is refused with the message "You cannot save the changes because the target object was modified by another user or process.", and your typed changes stay on the form.
IMPORTANT: Reloading discards your unsaved values and loads the other user's changes.
Values you enter again after the reload can be saved unless the record changes again.
To run further actions on an open record, see Perform Actions on Records. To change the same field on many records at once instead of one at a time, see Update Several Records at Once.
Lookups and references
Opening a lookup's drop-down loads its choices from the server. When the list holds 100 items, the limit, a banner appears above it, and typing then searches the server instead of only filtering the loaded items.
The ... button beside a lookup opens a menu:
- An item that opens the linked record in a fly-out form, without leaving the form you are on, when you may view that record.
- Items that open the linked record's own page, in the current browser tab or a new one, following your setting to open records in a new tab.
- An item that opens a picker for the lookup's own record type. A category lookup opens a category picker instead. When the lookup already holds a value, the record-type picker opens with that record focused.
The items that open the linked record are unavailable while the lookup has no value. The picker item is not offered on a read-only lookup or on some lookup types. On a read-only lookup, the ... button itself appears only once the lookup holds a value, and not on some lookup types. The field's caption itself is plain text, not a link.
The record-type picker has a search box, the matching records in a grid below it, and Select and Cancel at the bottom. Beside the search box, a drop-down lists the fields you can restrict the search to. You cannot switch the picker to another record type, and its grid has no toolbar, actions, or filters. Select stays unavailable until you choose a row (or, when several records can be picked at once, until you tick one or more); pressing Enter does the same as Select, and double-clicking a row picks it immediately. Cancel closes the picker without a value. If your personal setting not to prepopulate select dialogs is turned on, the grid stays empty until you search.
Hovering over a filled lookup to a Person for about half a second shows a preview card of that person. On a read-only form, a filled reference to a record can show an icon that opens that record, and a person reference shows the person's photo before the name.
Purchase order and company address references also accept typed text. Their ... menu has no fly-out item; picking a record through the picker replaces the typed text and fills in related fields: an invoice number from a purchase order, or address fields from a company address.
Picking a value for one lookup can clear another. After you change a reference field or a filtered lookup, every other editable filtered lookup on the form that holds a value is checked again against the current form values, and a value that no longer fits is cleared without a warning.
The form's tabs
The General tab holds the record's own fields, grouped into captioned sections, most of which you can collapse. Collapsing a section is not remembered: it opens expanded again the next time you open the form. User-defined fields appear either in their own section on the General tab, under the caption set for that section, or on the Custom Data tab. The section or tab is left out when it has no fields to show. The General tab can also show when the record was created and last modified, and by whom; for a record created by the system, the name is left out.
In the form layouts that ship with the product, most forms start with General and end with Custom Data, Related Objects, Notes, History, and Attachments, with the tabs specific to the record type in between or after Custom Data; see Attachments for the Attachments tab. Not every record type has every tab: Brand and Company Address records have only a General tab, a Stock Room has only General and Stock Movement, a Software Product has General, Notes, and Discovered Installations, and a Vendor Product has General, Notes, and Attachments. Some tabs are also left out of a record's form because of its data, never because of your rights: Approvals and Virtual Machines when the record has none, and a person's Technician and Work Calendar tabs when the person is not a technician.
Some tabs show a count of what is inside them, shown only when it is not zero, and a tab without a count, such as Notes, can show a small dot once it holds content. A tab you have visited stays loaded in the background when you switch away, so its scroll position and any unsaved typing are kept when you switch back. When your personal setting to show the record's activity on a separate tab is turned on (it is off by default), the activity moves to its own Activity tab in second place. For where each record type shows its activity, see Activity Log.
Double-clicking a row in a tab's grid, such as a purchase order's Items tab, opens that row's record in place of the current page, or in a new browser tab when your setting to open records in a new tab is turned on; some tabs always open their rows in a new browser tab. On some tabs, such as a computer's Discovered Installations or a consumable's Stock Movement, opening a row shows its details in a side panel instead, though a middle-click on the row's link still opens the record in a new browser tab. On a service catalog item's Categories tab, a row does not open at all.
Field kinds and their editors
Each field on the form uses the editor of its kind:
- Text - a filled field whose name contains "email" shows a mail icon that opens a new email; in any other text field, a value shaped like a web address shows a link icon that opens it in a new tab. A value that contains an IP address, a version number such as 1.2.3, or an email address, or that holds only numbers and dots, never gets the link icon.
- Number (whole number, decimal, or currency) - a whole-number field refuses a keystroke that would take the value out of its range; with no range of its own, it accepts -2,147,483,648 to 2,147,483,647. A decimal field refuses a keystroke past 15 digits in total or 9 decimal places, and the field's own number of decimal places limits typed decimals further (2 when the field sets none, or when it sets 0 on a field that is not a user-defined field). A currency field shows its currency symbol and trims typed digits beyond its precision (2 by default) instead of refusing them. A field recognized as a capacity field shows a formatted value, such as "8 GB", until you click into it to edit the number. The price fields of an Asset, PO Item, or Computer form also show a calculator icon.
- Date and date and time - pick from the calendar, or type a date directly. The calendar goes up to 100 years ahead. When you leave the field, a partial date is completed from today's date, and an invalid entry reverts to the last valid value. Clicking a day only selects it; confirm it with the picker's accept button to close the picker. The picker also has a button for today's date. A date field also closes on a double-click on a day.
- Duration - enter hours (up to 99,999) and minutes (0 to 59) in two separate boxes.
- Encrypted - a filled field always displays as a fixed row of eight asterisks, whatever the real value's length. You cannot edit part of the value; typing replaces the whole value.
- IP address - accepts only digits and dots. It does not check that what you type is a valid address, such as the number of parts or the range of each part.
- Memo - a multi-line text box that grows to fit up to four lines. Click the expand icon ("Open in the new window") to edit the text in a larger pop-up window titled with the field's caption. Click OK to write your text back to the field; Cancel, the close icon, Escape, or a click outside the window discards it. The pop-up's Insert menu is available while the pop-up's text box has focus: its timestamp item adds the current date and time at the cursor, and its snippet item opens your snippets; see Snippets. An inserted timestamp reaches the field only when you click OK. The pop-up keeps your typed text between openings, so reopening it after Cancel still shows the discarded edit until the field's value changes. On a read-only field, the pop-up shows the text read-only.
- Rich text - a formatting editor with a toolbar for text formatting, lists, links, tables, and images; you can paste or drop an image directly into the field. A pasted image address ending in .webp, .avif, or .svg is refused with the message "File format(s) are not supported." Some rich-text fields display as read-only text until you click the field's edit button. Click Source to switch to the underlying HTML, and click it again to switch back; while Source is on, the other toolbar buttons except Maximize are unavailable. You can mention a technician in the text; only active technicians can be mentioned, not requesters or inactive people. A technician added moments earlier may not be offered at once. For what a mention sends, see Mention Notifications. Beneath the toolbar, the editor also offers an AI actions button, which can replace the field's text with the AI's output, and a voice transcription button. In read-only rich text, clicking an image opens it in a dialog, clicking a link to a place in the same text scrolls to it, and clicking any other link opens it in a new browser tab.
- AI-generated text - an empty field generates its own draft as soon as the field is shown, unless AI features are turned off. Use Regenerate for another draft or Copy to copy it; some fields also offer a chat that can replace the field's text. With AI turned off, the field shows a notice instead of generated text, and Copy, Regenerate, and the chat are unavailable.
- Multi-select - five or fewer choices show as check boxes; more choices, or choices that come from a lookup, show as removable chips with a search box.
- Tags - shown as removable chips; click to search existing tags as you type, or create a new tag if you have permission to add tags.
- Lookup or reference - a link to another record; see Lookups and references below.
On the form, an empty text, number, currency, date, date-and-time, memo, lookup, or tags field, or an empty multi-select field shown as chips, shows two short gray dashes under the input instead of blank space. They disappear as soon as you point to the field or click into it.
In a rich-text field's dialogs, such as the link, image, and table dialogs, OK applies your changes and Cancel discards them. If you changed anything in the dialog, Cancel first asks "You have changed some options. Are you sure you want to close the dialog window?", and declining keeps the dialog open. The Cell Properties dialog refuses a width or height that is not a number with "Cell width must be a number." or "Cell height must be a number.", and a span that is not a whole number with "Rows span must be a whole number." or "Columns span must be a whole number." When you select table cells by dragging across them and press Delete or Backspace, the selected cells are emptied, and rows, or the whole table, that the selection covers completely are removed. For the editor's toolbar and its link, image, and table dialogs, see Format Text in HTML Fields.
Related topics
- Perform Actions on Records - run workflow actions on an open record.
- Update Several Records at Once - change a field across several records.
- Attachments - attach and manage files on a record.
- Form Layouts - how record forms are laid out.
- Work in the Settings App - records in the Settings App.