Home

Appendix

Application Icon   Metadata

DEVONthink stores a large number of metadata fields internally when importing documents from the file system, e.g., from PDF, RTF, MP3, EXIF/IPTC, HTML, and email messages as well as from all files that deliver metadata through the Spotlight metadata importer. Here's a partial list of theoretically supported fields:

File Metadata

General Metadata:

  • Icon
    Title
  • Icon
    Headline
  • Icon
    Subject
  • Icon
    Creator
  • Icon
    Producer
  • Icon
    Editor
  • Icon
    Contributor

PDF Metadata:

  • Icon
    Author
  • Icon
    Title
  • Icon
    Subject
  • Icon
    URL
  • Icon
    Keywords

RTF Metadata:

  • Icon
    Author
  • Icon
    Title
  • Icon
    Comment
  • Icon
    Subject
  • Icon
    URL
  • Icon
    Keywords
  • Icon
    Organization
  • Icon
    Copyright

Email Metadata:

  • Icon
    Authors
  • Icon
    Author email addresses
  • Icon
    Recipients
  • Icon
    Recipient email addresses
  • Icon
    Email addresses

Media and Publication Metadata:

  • Icon
    Album
  • Icon
    Composer
  • Icon
    Contributors
  • Icon
    Publishers
  • Icon
    Editors
  • Icon
    Organizations

MultiMarkdown Metadata:

  • Icon
    title
  • Icon
    description
  • Icon
    author
  • Icon
    comment
  • Icon
    subject
  • Icon
    organization
  • Icon
    keywords
  • Icon
    publisher
  • Icon
    email
  • Icon
    copyright
  • Icon
    generator
  • Icon
    dc.title
  • Icon
    dc.creator
  • Icon
    dc.subject
  • Icon
    dc.description
  • Icon
    dc.rights
  • Icon
    dc.contributor
  • Icon
    dc.keywords
  • Icon
    dc.publisher
  • Icon
    og:title
  • Icon
    og:description
  • Icon
    geo.position
  • Icon
    ibcm

Custom Metadata

Another powerful feature of DEVONthink is custom metadata fields. Specified in the Settings > Data, you can define fields that are meaningful to you, your company, your research group, or even your family!

When you create a custom metadata field, you give it a name. DEVONthink uses this name to create an identifier for use in automated processes. This identifier is created automatically and cannot be changed.

Data Types: When you define a custom field, you choose a data type for it. So what's a "data type"? It's simply a kind of a value; like "a" is a character and "42" is a (the!) number. The following data types are supported, including any interface items associated with them, e.g., checkboxes or dropdown menus:

  • Icon
    Boolean: This is a true or false value. Displayed as a checkbox.
  • Icon
    Countries: A dropdown menu providing a list of country names. Supports an Undefined state
  • Icon
    Languages: A dropdown menu providing a list of languages. Supports an Undefined state
  • Icon
    Integer: A whole number, e.g., with no fractional part, like 17.
  • Icon
    Decimal Number: A fractional number, represented with a decimal point.
  • Icon
    Date: Can be specified as Date & Time or Date.
  • Icon
    Identifier: Any alphanumeric value, specified as needed, e.g., a customer or patient number.
  • Icon
    Single-line Text: A dropdown providing a list of terms you defined for the field in the Data preferences. You can also type in a new value.
  • Icon
    Multi-line Text: Enter a small paragraph of text. Line breaks can be typed by pressing Option-Return.
  • Icon
    Rich Text: Same as Multi-line text but supports basic formatting, e.g., bold or italic text.
  • Icon
    Set: Similar to the Single-line text, this shows a dropdown with values pre-defined for the field in the Data preferences. However, new values can't be entered outside the preferences. Supports an Undefined state.
  • Icon
    URL: Accepts any valid URL, including filesystem URLs.
  • Icon
    Link: A special dropdown that allows you to choose an item in your databases. a link for the chosen item is used.

Note the metadata attributes that support an Undefined option: Countries, Languages, and Sets. This can be used anywhere custom metadata is displayed, e.g., in an item list column or the Data inspector. You can search for this by leaving the term empty, e.g., mdcountry!= is equal to "The Country attribute is not Undefined.", meaning a Country attribute has been set on an item.

Note: The Countries and Languages lists are lengthy, but not necessarily exhaustive. For Multi-line Text and Rich Text, only one line will be displayed in its column in the item list.

Predefined Custom Metadata: In Settings > Data, we have provided some custom metadata fields to get you started. These are ready to use and explore and serve as great examples of the data types discussed above:

  • Icon
    Date
  • Icon
    Company
  • Icon
    Author
  • Icon
    Abstract
  • Icon
    Status
  • Icon
    Serial Number
  • Icon
    ISSN/ISBN
  • Icon
    Digital Object Identifier (DOI)
  • Icon
    PubMed ID
  • Icon
    PMC ID
  • Icon
    Barcode
  • Icon
    Format
  • Icon
    Category
  • Icon
    Subcategory
  • Icon
    Genre
  • Icon
    Country
  • Icon
    Language
  • Icon
    Price
  • Icon
    Tax
  • Icon
    Tip
  • Icon
    Decimal