diff --git a/typings/xterm.d.ts b/typings/xterm.d.ts
index 39f2bfb0..234b7ea0 100644
--- a/typings/xterm.d.ts
+++ b/typings/xterm.d.ts
@@ -636,7 +636,26 @@ declare module 'xterm' {
     readonly modes: IModes;
 
     /**
-     * Get the terminal options
+     * Gets or sets the terminal options. This supports setting multiple options.
+     *
+     * @example Get a single option
+     * ```typescript
+     * console.log(terminal.options.fontSize);
+     * ```
+     *
+     * @example Set a single option
+     * ```typescript
+     * terminal.options.fontSize = 12;
+     * ```
+     *
+     * @example Set multiple options
+     * ```typescript
+     * terminal.options = {
+     *   fontSize: 12,
+     *   fontFamily: 'Arial',
+     * ;
+     * ```
+     */
      */
     options: ITerminalOptions;