Home

Appendix

Application Icon   Placeholders

One of the most powerful features of DEVONthink is the ability to insert data dynamically. A placeholder is a bit of code DEVONthink interprets when used in these scenarios, replacing it with a specific value. You may have an imprint with a Name placeholder defined in the title. When the imprint is used on a PDF, the placeholder is converted to the name of the file!

To extend the possibilities even further, you can combine static text and multiple placeholders to achieve truly custom results. You can use these in smart rules and the command Tools > Batch Process, in alarms on Reminders, custom imprints on images and PDFs, and in templates for creating WikiLinks documents.

Below is a list of placeholders currently available:

  • Icon
    Name: The name or title of the document.
  • Icon
    Proposed Name: A suggested name derived from a document's title or from the first line of the document if no title is present.
  • Icon
    Aliases: Any aliases applied to the file.
  • Icon
    Finder Comment: Any Finder comments applied to the file.
  • Icon
    File Name: The filename in the file system.
  • Icon
    File Extension: The extension of the file.
  • Icon
    Kind: The kind of the file, e.g., group or rich text document.
  • Icon
    URL: The URL in the Info pane.
  • Icon
    Location: The location in the database; e.g., /Inbox/Research.
  • Icon
    Tags: Tags applied to the file.
  • Icon
    Digital Object Identifier: The unique digital object identifier of the file, if available.
  • Icon
    Item Link: A universal URL referencing the document.
  • Icon
    Index: This is a number that increments based on the number of items being processed by a smart rule.
  • Icon
    Counter: Similar to the Index, this is a zero-padded incrementing number.
  • Icon
    Document Amount: This is an amount detected in the name or content of documents, like receipts or invoices. Often used with smart rules.
  • Icon
    Document String: This is a string detected in the name or content of documents. Typically used with smart rules.
  • Icon
    Bates Number: Inserts a Bates number.
  • Icon
    Page Count: The total number of pages in the document.
  • Icon
    Group Name: The name of the group containing the document, e.g., /001/a/b/myfile.txt would report b as the group name.
  • Icon
    Top Group Name: The name of the top level group in the root of the database, e.g., /001/a/b/myfile.txt would report 001 as the top group name.
  • Icon
    Database Name: The name of the database containing the document.
  • Icon
    Database Path: The filesystem path of the database.
  • Icon
    Attachments: The number of attachments in a file.
  • Icon
    Language: An abbreviation of language detected in the document's indexed contents.
  • Icon
    Country: The country in the geolocation data for a file.
  • Icon
    Postal Code: The postal code derived from the geolocation data for a file.
  • Icon
    Administrative Area: This is state, province, or region in the geolocation data for a file.
  • Icon
    Locality: The city in the geolocation data for a file.
  • Icon
    Tab: A tab character.
  • Icon
    Line Break: A line break (return) character for multi-line text.
  • Icon
    Current Date: Today's date.
  • Icon
    Addition Date: The date the file added to the database.
  • Icon
    Creation Date: The date the file was created.
  • Icon
    Modification Date: The date the document was last modified.
  • Icon
    Document Date: This is a date detected in the document's contents, e.g., in a receipt. For PDFs only the first four pages are used.
  • Icon
    Newest/Oldest Document Date: The newest or oldest date detected in the document. For PDFs, only the first four pages are used.

When using dates, you can choose the format as defined in System Preferences > Language & Region > Advanced > Dates. The default is the medium format, but you may choose short or long formats as well. You can also choose specific parts of the date or time, e.g., the month, year, or hour only.

  • Icon
    Clipboard: Inserts content currently on the clipboard. It can be inserted as rich text, plain text, or a link, depending on the type of data and the file the data is inserted into.
  • Icon
    Predefined Author: This is the Author specified in DEVONthink's Preferences > Editing.
  • Icon
    Username: The shortname of the current macOS account.
  • Icon
    Full Username: The longname of the current macOS account.
  • Icon
    Organization: This is the company name, if defined by the (Me) contact card in macOS Contacts.
  • Icon
    Email Address: The primary email address, as defined by the (Me) contact card in macOS Contacts.
  • Icon
    Host: The hostname of the machine.

Properties: These are potential metadata properties found in the current file. A more extensive listing of these can be found in the Metadata section.

Custom Metadata: This menu lists any custom metadata fields applied to the file.