🏠/notes.ini Parameters/FT_INDEX_FILTER_ATTACHMENT_TYPES

FT_INDEX_FILTER_ATTACHMENT_TYPES

Parameter: FT_INDEX_FILTER_ATTACHMENT_TYPES
Short description: Whitelist of allowed file extensions for full-text indexing of attachments — overrides the default list of all formats supported by Tika.

Profile

Parameter
FT_INDEX_FILTER_ATTACHMENT_TYPES
Category
Performance / Memory
Component
Server, client
Available since
10.0 (Tika filter; replaces KeyView)
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
Configuration document (NOTES.INI tab) or Desktop Settings policy (Notes client)
Possible values
Comma-separated list of extensions, e.g. *.pdf,*.zip,*.jar

Description

FT_INDEX_FILTER_ATTACHMENT_TYPES defines a whitelist of file extensions whose contents are extracted and included in the FT index during full-text indexing of attachments via the Apache Tika filter (since Domino 10). By default, all formats supported by Tika 1.18 are processed — with the exception of a hard-wired exclude list (including .exe, .dll, .gif, .jpg, .png, .mp3, .zip, .tar, .gz, .nsf, .ntf).
If the parameter is set, the specified list overrides the default processing: only the extensions explicitly named here are indexed. This allows the indexing effort to be massively reduced (especially useful on servers with large mail/archive databases). For a per-database configuration, the variant FT_INDEX_FILTER_ATTACHMENT_TYPES_<replicaID> is available; the size limit per attachment is regulated by the companion parameter FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB.
For Notes clients, the parameter affects local indexing; for Domino servers, it can be distributed via Configuration document to multiple servers at once, for Notes clients via Desktop Settings policy → Custom Settings → notes.ini.

Example configuration

Full-text index only PDF, ZIP, and JAR attachments:
FT_INDEX_FILTER_ATTACHMENT_TYPES=*.pdf,*.zip,*.jar
FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB=5
Index only Office and PDF documents:
FT_INDEX_FILTER_ATTACHMENT_TYPES=*.doc,*.docx,*.xls,*.xlsx,*.ppt,*.pptx,*.pdf
Per-database configuration (only .txt attachments in a specific replica):
FT_INDEX_FILTER_ATTACHMENT_TYPES_652586AE00240ED9=*.txt
FT_INDEX_FILTER_ATTACHMENT_TYPES_652586AE00240ED9_MAX_MB=2

Notes & pitfalls

  • Available since Domino 10 along with the switch from KeyView to Apache Tika filter.
  • Once set, the list overrides the Tika default processing — extensions not listed are excluded.
  • Companion parameters: FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB (size limit per attachment in MB), per-DB variants via _<replicaID> suffix.
  • Exclusion via the default exclude list (.exe, .dll, .zip, .gif, ...) remains in effect, unless extensions are explicitly included.
  • Distribution in practice: for servers via Configuration document (NOTES.INI tab), for Notes clients via Desktop Settings policy (Custom Settings → notes.ini).
  • Takes effect after server/client restart or reload of the configuration.

Sources (HCL Product Documentation)