Skip to main content

Solutions

Law firms

Tax, audit & accounting firms

Corporations

Governments

Products

Legal

Trade & supply

Tax, audit & accounting

Corporate tax

Risk & fraud

Books

Recommended products

Questions? We are here to help.
Contact us

Purchase

Buy solutions

Buy books

Contact sales

Questions? We are here to help.

Resources

Insights

Events

Product training

Product communities

Developers

Getting Started

AI Expression Explainer

Gain deeper insight into your template logic with the new
AI Expression Explainer
. This tool provides clear, natural language explanations for fields, spans, and computable definitions directly within the Markup and Dictionary Editors.
The explainer provides:
  • Expanded expressions that include definitions of all computables.
  • An easy-to-understand overview explaining the overall purpose of the expression.
  • A detailed breakdown listing each component and its definition.
  • Helps quickly understand and fix errors, reducing confusion and saving time when working with complex expressions.
This feature requires
Advanced AI
 to be enabled, as it leverages information from your template dictionary to deliver accurate, context-aware explanations.
AI Expression Explainer is available in Author Desktop starting with version 10.17.

How to use Expression Explainer

You can access
Expression Explainer
 from the following locations:

Author Desktop

  • In the Markup Editor
    , via the
    AI icon
     in the tools ribbon.
  • In the Dictionary Editor
    , via the
    AI Explain
     button in the
    Computation
     tab of any computable variable.
If an incorrect or incomplete expression is provided, the Expression Explainer in Author Desktop displays an error message explaining why the expression is not working. It clearly describes what the expression is trying to do, what the error means, and provides simple guidance on how to correct syntax or usage issues.
When errors are detected, the Explainer highlights changes in the suggested expression by marking added sections in green and removed sections in red, making it easy to compare the suggested expression with the original. When you copy the suggested expression (use the icon), any deleted content is automatically excluded, ensuring that only the final, corrected expression is copied to the clipboard for reuse.

Author Online

In the
Markup Expression
 panel, via the
AI explain
 icon in the top‑right corner of any computable variable within Advanced Mode and for computation variables.
note
If the icons do not appear, ensure that Advanced AI features are enabled for your account and that both the Author add‑in and the Contract Express instance you are connected to are version 10.17 or later.
To generate an explanation, simply click the
AI icon
 or the
AI Explain button
. A new window will open showing the explanation for the expression you are currently working on.
In Author Desktop, the information shown in the window is static and will not update automatically. You can close the window at any time. Each time you launch Expression Explainer, whether for the same expression or a different one, a
new
 window will open, which you can keep open or close as needed.
However, Author Online supports only a single active window; therefore, multiple Expression Explainer windows cannot be opened simultaneously.

Expanded Expression

Before an expression is sent to the LLM for analysis, the Contract Express server first processes it by expanding all source components and applying server‑side optimisations. If your expression includes computables or custom functions, these will be fully expanded during this step. Server optimisations may also alter the structure of the expression, so the version analysed by the LLM may differ from what you originally wrote.
When this occurs, the explanation window will display the expanded and optimised expression directly below the original one. The explanation will be provided for the expanded version.

This article applies to:

  • Product: Contract Express