Fields and tags: questions and answers
Short answers about describing files: custom fields and their kinds and options, setting values on one file or many, filtering by field, tags and their rules, and the built-in description, caption and alt text. Each answer links to the section of Fields and tags that owns the rule.
The basics
- What are fields and tags for?
- Which kinds of description can a file carry?
- What is the difference between a tag and a custom field?
- Do field values or tags decide who can open a file?
- Who can read a file's field values, details and tags?
- Do I need a verified email to work with fields and tags?
- Is anyone notified when a field is added or deleted?
- Does Talewright tag or describe files automatically?
- Does Talewright recognize faces or objects in images?
Custom fields and their kinds
- What is a custom field?
- Which kinds of custom field are there?
- What does a "Text" field hold?
- What does a "Number" field hold?
- What does a "Date" field hold?
- What does a "Single select" field hold?
- What does a "Multi-select" field hold?
- Can a date field hold a time of day?
- Can I change a field from "Text" to "Single select"?
- Is there a checkbox or yes/no field?
- Is there a field kind for links, people or currency?
- Does a new organization have any custom fields?
- Does every workspace have its own custom fields?
- Can another organization read or use our custom fields?
Creating a field
- How do I add a custom field?
- Who can add, rename or delete a custom field?
- Can a member define a custom field?
- Why does defining a field with an API key answer
SESSION_REQUIRED? - Can I give a new field a default value?
- Can I make a field required?
- Can I create a select field first and add its options later?
- How do I enter the options when I add a select field in the app?
- What happens when two options in the "Add field" request have the same name?
- Why does "Add field" say "Enter a name of 1 to 60 characters."?
- Why does "Add field" say "That name is taken."?
- Why does "Add field" say "Use at most 100 options of 1 to 60 characters each."?
- How do I make room for a new field when a workspace or the organization folder has 50?
- Can a custom field be named "Status"?
- Can a field name contain a tab or a line break?
- Which kind does the "Add field" dialog start on?
- What happens when two admins add the 50th field at the same moment?
Options of a select field
- What is the difference between an "option" and a "choice"?
- How do I add an option to an existing field?
- Which fields can have options?
- Can two different fields have an option with the same name?
- Does a file store the name of a chosen option or its ID?
- How do I change the order of a field's options?
- How does the settings page show a field's options?
Renaming and ordering fields
- How do I rename a field or an option?
- Does renaming a field or an option change my files?
- Where does a renamed field show its new name?
- What happens when I rename a field to a name another field has?
- Can I change only the capital letters in a field's name?
- How do I change the order of the custom fields?
- Where does the order of the fields show?
- Can I move a custom field above the status?
- Why did reordering the fields fail after another admin added one?
Deleting fields and options
- How do I delete a custom field?
- What happens to the values when I delete a field?
- What does "{n} files will lose this value." mean?
- What does "7 files will lose this value, and so will 2 files in the trash." mean?
- What does "No file has this value." mean?
- Does the API ask before it deletes a field?
- What changes on a file when a field it had a value for is deleted?
- How do I delete an option of a select field?
- What happens when I delete an option that files use?
- Does search still find the text of a deleted field?
- What happens when a field is deleted from two browsers at once?
Counts
Setting field values on a file
- How do I fill in a custom field on a file?
- Who can fill in the fields of a file?
- Can a member set field values on an organization folder file?
- Which input does each kind of field get on a file's page?
- How do I clear a field value on a file?
- Why is "Save fields" disabled?
- Does "Save fields" also save what I typed in "Details"?
- Does a newly uploaded file have field values?
- Do field values survive when I replace a file with a new version?
- Does a file keep its field values while it is in the trash?
- Can a file have two values for the same field?
- What do I see in "Fields" when I cannot change the file?
- What does the section "Fields" show when the workspace or organization folder has no custom fields?
- What does setting a value do to the value the file had?
Field values in the API
- How are field values sent in a request?
- What value does each kind of field take in the API?
- Why is
"12"refused for a number field? - Which values clear a text field?
- Which values clear a multi-select field?
- Why is a list refused for a single select field?
- Why is a single choice ID refused for a multi-select field?
- Which date values does a date field refuse?
- Can a text field value contain tabs and line breaks?
- In what order does the API return the choices of a multi-select value?
- What happens when a multi-select value names the same choice twice?
- What happens when one of several field values in a request is invalid?
- Do file lists and search results carry field values?
- How does the API show a field that has no value on a file?
- Does setting a field to the value it already has count as a change?
- In what order is a change to a file's values checked?
- What happens when a value is sent for a field of another workspace or organization?
- Can a key with only
files:readset a field value? - How much does the
lockVersionmove when one request changes several details?
Setting a field on many files
- How do I set a field on many files at once?
- How do I set a field on a whole folder?
- Why is "Set field" missing from the toolbar "Selected files"?
- How do I clear a field on many files at once?
- What happens to folders in my selection when I choose "Set field"?
- What happens when I set a field on more than 100 selected files?
- Can I set a field from the command palette?
- Is setting one field on many files all or nothing?
- Does setting a field on many files need each file's
lockVersion? - Can one batch request set two different fields?
- Can the batch field operation set the status?
- What happens when a batch field request leaves out
value? - Does a batch field change touch files that already had the value?
- What happens to a file page I had open when someone sets a field in a batch?
- Why does setting a field say "A selected file is in the trash. Clear the selection and try again."?
- Why does setting a field say "A selected file no longer exists. The list is up to date now."?
Filtering by field
- How do I filter files by a custom field in the app?
- Which fields appear in the Filter menu?
- What do "Any" and "Not set" mean in a field's filter group?
- Can I filter by a text, number or date field?
- Can I filter by a date range or a number range?
- Can I filter by two options of the same field?
- How do filters on several fields combine?
- Does a field filter look only in the open folder?
- How do I find the files that still have no value for a field?
- Does a file with several options match a filter on one of them?
- Can a field filter be combined with search, tags and status?
- How do I see how many filters are on, and turn them off?
- What does a filter on a text field with a choice ID answer?
- Which files match a filter on a select option that was deleted?
- Does search find the values of custom fields?
Tags
- What is a tag?
- How do I add a tag to a file?
- How do I remove a tag from a file?
- Do I have to create a tag before I can use it?
- Who can tag files?
- Why do my tags turn lower case?
- Can a tag contain spaces?
- Which characters can a tag contain?
- Are tags shared between workspaces?
- What happens when I type the same tag twice on a file?
- What happens to empty entries such as "a, , b" in the "Tags" box?
- In what order are a file's tags shown?
- Where do I see a file's tags in the file list?
- Does a file keep its tags when it gets a new version?
- How does the API set a file's tags?
- Do 60 tag names that normalize to 40 tags fit on one file?
- What happens to a file's tags when I send 51 different ones?
- Can I tag many files at once in the app?
- Can I tag a folder?
Managing tags
- Where is the list of all tags of a workspace?
- Why is a tag still offered in the filter when no file has it?
- How do I rename a tag on every file at once?
- Can I rename or delete a tag in the app?
- Why can I not rename or delete tags in the app?
- What does the app ask before it deletes a tag?
- How do I delete a tag everywhere?
- Who can rename or delete a tag?
- How do I merge two tags into one?
- What happens when I rename a tag to the name of another tag?
- Does a renamed tag keep its ID?
- What does renaming a tag do to the files that carry it?
- What happens when I rename "brand" to "BRAND"?
- What happens when I use the name of a deleted tag again?
- How do I filter files by tag?
- Can I filter by two tags at once?
- Why is there no "Tag" group in my Filter menu?
- What does a tag's
fileCountcount? - What does a
tagfilter with the ID of another workspace's tag return? - Can a tag be proposed for review and not set directly?
- What do the tag operations of the API answer?
Description, caption and alt text
- Which built-in details does every file have?
- What is the difference between a description and a caption?
- What is alt text for?
- How do I add alt text to an image?
- Why is there no "Alt text" on my PDF or video?
- What happens when I paste several lines into "Alt text"?
- Why does a save say "Remove the tab or other character that cannot be saved."?
- How do I remove a description, a caption or an alt text?
- Can a description or a caption have several lines?
- Can I rename "Caption" or add built-in details of my own?
- Are description, caption and alt text custom fields?
- Do description, caption and alt text survive a new version of the file?
- Does the alt text travel with a file's public link?
- Why is "Save details" disabled?
- Which boxes in the form "File details" take several lines?
- What does "None" mean under "Description" or "Caption"?
Saving at the same time as someone else
- Why was my save refused with "This file changed since you opened it"?
- What is a file's
lockVersion? - Which changes move a file's
lockVersion? - Does uploading a new version move the
lockVersion? - Can two people overwrite each other's edits to a file's details?
- What should an agent do after
STALE_LOCK_VERSIONon a details change? - What happens when a change names nothing to change?
- An admin deleted a field while I had a file open. What happens when I save?
Search, export and the audit trail
- Which of a file's details does search look at?
- How soon can I search for a tag or description I just saved?
- Does search match the middle of a word in a description or tag?
- What does an organization export hold about fields and tags?
- Which audit events record changes to fields and tags?
- How many audit events does setting one field on many files record?
Agents and the API
- Which MCP tools work with fields and field values?
- Why should an agent list the fields before it sets a value?
- Why is the first item of the field list called
status? - What do
builtinandallowsPublicread on a custom field? - How does an agent work through the files that miss a field?
- Can an agent define fields or options?
- Does an organization folder version exist for every field and tag operation?
- What do the browser-only field operations take and return?