About the SYS Field Name Prefix

While reviewing the fields associated with an item in the Content Browser, you might have noticed some field names with the prefix sys (see Content Browser - Page if using Coveo Cloud V2). These fields may appear redundant, since their value is identical to the value of fields with the same name, minus the sys prefix.

  • date and sysdate

  • filetype and sysfiletype

  • size and syssize

These field pairs coexist for compatibility reasons. In Coveo Enterprise Search (CES) and Coveo Cloud V1 indexes, the names of the system fields are prefixed with sys (Coveo Enterprise Search 7.0 and Coveo Cloud V1). This prefix was abandoned in Coveo Cloud V2. However, for backward compatibility reasons the Coveo REST Search API still includes the older field names (see REST Search API).

Coveo JavaScript Search Framework 1.0.318 - February 2016  REST Search API 8.0.1028 - February 2016  The Coveo JavaScript Search Framework leverages a Coveo REST Search API version that ensures that both field names can be used, i.e., with and without the sys prefix. This accommodates all customers, regardless of their index version. Therefore, you may build search page templates and make queries leveraging either field name without any noticeable difference (see Configuring JavaScript Search Result Templates and Coveo Cloud Query Syntax Reference).

In a future version of the Coveo Cloud REST Search API, fields prefixed with sys will not be available anymore, regardless of the index used. Therefore, future Coveo REST Search API releases will alter the functioning of search pages built using sys field names. Such a major breaking change will be announced in the Coveo Cloud New Features page.

To prepare for these future upgrades and keep your Coveo Cloud powered search page running smoothly, you should make sure that your search page does not encompass field names with the sys prefix anymore.

Older Coveo JavaScript Search Framework versions leverage different versions of the Coveo REST Search API. These versions handle field names with the sys prefix regardless of whether you use a Coveo Cloud V2, CES, or Coveo Cloud V1 index. If you use such a JavaScript Search Framework version, you must use field names with the sys prefix.