OfficeDev · alison-mk · Jul 11, 2025 · Jul 11, 2025
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
@@ -54,7 +54,7 @@
   },
   "JoinTOCPlugin": [
     {
-      "ReferenceTOC": "docs/docs-ref-autogen/excel/toc.yml",
+      "ReferenceTOC": "docs/docs-ref-autogen/toc.yml",
       "ConceptualTOCUrl": "/office/dev/scripts/toc.json"
     }
   ],

diff --git a/docs/docfx.json b/docs/docfx.json
@@ -56,15 +56,7 @@
           "**/*.yml"
         ],
         "group": "office-scripts",
-        "src": "docs-ref-autogen/excel",
-        "dest": "api/office-scripts"
-      },
-      {
-        "files": [
-          "excel.yml"
-        ],
-        "group": "office-scripts",
-        "src": "docs-ref-autogen/excel",
+        "src": "docs-ref-autogen",
         "dest": "api/office-scripts"
       },
       {

diff --git a/docs/docs-ref-autogen/excel/excelscript/excelscript.cellcontrol.yml b/docs/docs-ref-autogen/excel/excelscript/excelscript.cellcontrol.yml
diff --git a/docs/docs-ref-autogen/excel/excelscript/global.officescript.emailcontenttype.yml b/docs/docs-ref-autogen/excel/excelscript/global.officescript.emailcontenttype.yml
diff --git a/docs/docs-ref-autogen/excel/excelscript.yml → docs/docs-ref-autogen/excelscript.yml b/docs/docs-ref-autogen/excel/excelscript.yml → docs/docs-ref-autogen/excelscript.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSPackage
+### YamlMime:TSPackage
 uid: ExcelScript!
 name: ExcelScript
 type: package
@@ -150,8 +150,6 @@ enums:
   - ExcelScript!ExcelScript.VerticalAlignment:enum
   - ExcelScript!ExcelScript.WorkbookLinksRefreshMode:enum
   - ExcelScript!ExcelScript.WorksheetPositionType:enum
-  - ExcelScript!Global.OfficeScript.EmailContentType:enum
-  - ExcelScript!Global.OfficeScript.EmailImportance:enum
 interfaces:
   - ExcelScript!ExcelScript.AllowEditRange:interface
   - ExcelScript!ExcelScript.AllowEditRangeOptions:interface
@@ -321,123 +319,5 @@ interfaces:
   - ExcelScript!ExcelScript.WorksheetProtection:interface
   - ExcelScript!ExcelScript.WorksheetProtectionOptions:interface
   - ExcelScript!ExcelScript.WorksheetSearchCriteria:interface
-  - ExcelScript!Global.OfficeScript.EmailAttachment:interface
-  - ExcelScript!Global.OfficeScript.MailProperties:interface
 typeAliases:
   - ExcelScript!ExcelScript.CellControl:type
-functions:
-  - name: Global.OfficeScript.convertToPdf()
-    uid: ExcelScript!Global.OfficeScript.convertToPdf:function(1)
-    package: ExcelScript!
-    summary: >-
-      Return the text encoding of the document as a PDF. If the document is
-      empty, then the following error is shown: "We didn't find anything to
-      print". Some actions made prior to using this API may not be captured in
-      the PDF in Excel on the web.
-    remarks: ''
-
-    isPreview: true
-    isDeprecated: false
-    syntax:
-      content: 'export function convertToPdf(): string;'
-      return:
-        type: string
-        description: The content of the workbook as a string, in PDF format.
-  - name: |-
-      Global.OfficeScript.downloadFile({
-                  name,
-                  content,
-              })
-    uid: ExcelScript!Global.OfficeScript.downloadFile:function(1)
-    package: ExcelScript!
-    summary: >-
-      Downloads a specified file to the default download location specified by
-      the local machine.
-    remarks: ''
-
-    isPreview: true
-    isDeprecated: false
-    syntax:
-      content: |-
-        export function downloadFile({
-                    name,
-                    content,
-                }: {
-                    name: string;
-                    content: string;
-                }): void;
-      parameters:
-        - id: |-
-            {
-                        name,
-                        content,
-                    }
-          description: ''
-          type: |-
-            {
-                        name: string;
-                        content: string;
-                    }
-      return:
-        type: void
-        description: ''
-  - name: Global.OfficeScript.Metadata.getScriptName()
-    uid: ExcelScript!Global.OfficeScript.Metadata.getScriptName:function(1)
-    package: ExcelScript!
-    summary: Get the current executing scripts name.
-    remarks: ''
-
-    isPreview: true
-    isDeprecated: false
-    syntax:
-      content: 'export function getScriptName(): string;'
-      return:
-        type: string
-        description: ''
-  - name: Global.OfficeScript.saveCopyAs(filename)
-    uid: ExcelScript!Global.OfficeScript.saveCopyAs:function(1)
-    package: ExcelScript!
-    summary: >-
-      Saves a copy of the current workbook in OneDrive, in the same directory as
-      the original file, with the specified file name. The API has a timeout
-      limit of 30 seconds. This limit is rarely exceeded. Note: Timeout doesn't
-      necessarily indicate that the API failed. The workbook copy may still be
-      created, but after the timeout limit this API does not return a success or
-      failure message.
-    remarks: ''
-
-    isPreview: true
-    isDeprecated: false
-    syntax:
-      content: 'export function saveCopyAs(filename: string): void;'
-      parameters:
-        - id: filename
-          description: >-
-            The file name of the copied and saved file. The file name must end
-            with ".xlsx".
-          type: string
-      return:
-        type: void
-        description: ''
-  - name: Global.OfficeScript.sendMail(mailProperties)
-    uid: ExcelScript!Global.OfficeScript.sendMail:function(1)
-    package: ExcelScript!
-    summary: >-
-      Send an email with an Office Script. Use `MailProperties` to specify the
-      content and recipients of the email. If the request body includes content,
-      this method returns 400 Bad request.
-    remarks: ''
-
-    isPreview: true
-    isDeprecated: false
-    syntax:
-      content: 'export function sendMail(mailProperties: MailProperties): void;'
-      parameters:
-        - id: mailProperties
-          description: ''
-          type: >-
-            <xref uid="ExcelScript!Global.OfficeScript.MailProperties:interface"
-            />
-      return:
-        type: void
-        description: ''
diff --git a/...cript/excelscript.aggregationfunction.yml → ...cript/excelscript.aggregationfunction.yml b/...cript/excelscript.aggregationfunction.yml → ...cript/excelscript.aggregationfunction.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.AggregationFunction
 uid: ExcelScript!ExcelScript.AggregationFunction:enum
 package: ExcelScript!

diff --git a/...xcelscript/excelscript.alloweditrange.yml → ...xcelscript/excelscript.alloweditrange.yml b/...xcelscript/excelscript.alloweditrange.yml → ...xcelscript/excelscript.alloweditrange.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.AllowEditRange
 uid: ExcelScript!ExcelScript.AllowEditRange:interface
 package: ExcelScript!

diff --git a/...ipt/excelscript.alloweditrangeoptions.yml → ...ipt/excelscript.alloweditrangeoptions.yml b/...ipt/excelscript.alloweditrangeoptions.yml → ...ipt/excelscript.alloweditrangeoptions.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.AllowEditRangeOptions
 uid: ExcelScript!ExcelScript.AllowEditRangeOptions:interface
 package: ExcelScript!

diff --git a/...l/excelscript/excelscript.application.yml → ...n/excelscript/excelscript.application.yml b/...l/excelscript/excelscript.application.yml → ...n/excelscript/excelscript.application.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.Application
 uid: ExcelScript!ExcelScript.Application:interface
 package: ExcelScript!

diff --git a/...celscript/excelscript.arrowheadlength.yml → ...celscript/excelscript.arrowheadlength.yml b/...celscript/excelscript.arrowheadlength.yml → ...celscript/excelscript.arrowheadlength.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.ArrowheadLength
 uid: ExcelScript!ExcelScript.ArrowheadLength:enum
 package: ExcelScript!

diff --git a/...xcelscript/excelscript.arrowheadstyle.yml → ...xcelscript/excelscript.arrowheadstyle.yml b/...xcelscript/excelscript.arrowheadstyle.yml → ...xcelscript/excelscript.arrowheadstyle.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.ArrowheadStyle
 uid: ExcelScript!ExcelScript.ArrowheadStyle:enum
 package: ExcelScript!

diff --git a/...xcelscript/excelscript.arrowheadwidth.yml → ...xcelscript/excelscript.arrowheadwidth.yml b/...xcelscript/excelscript.arrowheadwidth.yml → ...xcelscript/excelscript.arrowheadwidth.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.ArrowheadWidth
 uid: ExcelScript!ExcelScript.ArrowheadWidth:enum
 package: ExcelScript!

diff --git a/.../excelscript/excelscript.autofilltype.yml → .../excelscript/excelscript.autofilltype.yml b/.../excelscript/excelscript.autofilltype.yml → .../excelscript/excelscript.autofilltype.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.AutoFillType
 uid: ExcelScript!ExcelScript.AutoFillType:enum
 package: ExcelScript!

diff --git a/...el/excelscript/excelscript.autofilter.yml → ...en/excelscript/excelscript.autofilter.yml b/...el/excelscript/excelscript.autofilter.yml → ...en/excelscript/excelscript.autofilter.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.AutoFilter
 uid: ExcelScript!ExcelScript.AutoFilter:interface
 package: ExcelScript!

diff --git a/...cript/excelscript.basicdatavalidation.yml → ...cript/excelscript.basicdatavalidation.yml b/...cript/excelscript.basicdatavalidation.yml → ...cript/excelscript.basicdatavalidation.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.BasicDataValidation
 uid: ExcelScript!ExcelScript.BasicDataValidation:interface
 package: ExcelScript!

diff --git a/...excel/excelscript/excelscript.binding.yml → ...togen/excelscript/excelscript.binding.yml b/...excel/excelscript/excelscript.binding.yml → ...togen/excelscript/excelscript.binding.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.Binding
 uid: ExcelScript!ExcelScript.Binding:interface
 package: ExcelScript!

diff --git a/...l/excelscript/excelscript.bindingtype.yml → ...n/excelscript/excelscript.bindingtype.yml b/...l/excelscript/excelscript.bindingtype.yml → ...n/excelscript/excelscript.bindingtype.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.BindingType
 uid: ExcelScript!ExcelScript.BindingType:enum
 package: ExcelScript!

diff --git a/...l/excelscript/excelscript.borderindex.yml → ...n/excelscript/excelscript.borderindex.yml b/...l/excelscript/excelscript.borderindex.yml → ...n/excelscript/excelscript.borderindex.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.BorderIndex
 uid: ExcelScript!ExcelScript.BorderIndex:enum
 package: ExcelScript!

diff --git a/...celscript/excelscript.borderlinestyle.yml → ...celscript/excelscript.borderlinestyle.yml b/...celscript/excelscript.borderlinestyle.yml → ...celscript/excelscript.borderlinestyle.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.BorderLineStyle
 uid: ExcelScript!ExcelScript.BorderLineStyle:enum
 package: ExcelScript!

diff --git a/.../excelscript/excelscript.borderweight.yml → .../excelscript/excelscript.borderweight.yml b/.../excelscript/excelscript.borderweight.yml → .../excelscript/excelscript.borderweight.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.BorderWeight
 uid: ExcelScript!ExcelScript.BorderWeight:enum
 package: ExcelScript!

diff --git a/.../excelscript/excelscript.builtinstyle.yml → .../excelscript/excelscript.builtinstyle.yml b/.../excelscript/excelscript.builtinstyle.yml → .../excelscript/excelscript.builtinstyle.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.BuiltInStyle
 uid: ExcelScript!ExcelScript.BuiltInStyle:enum
 package: ExcelScript!

diff --git a/...celscript/excelscript.calculationmode.yml → ...celscript/excelscript.calculationmode.yml b/...celscript/excelscript.calculationmode.yml → ...celscript/excelscript.calculationmode.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.CalculationMode
 uid: ExcelScript!ExcelScript.CalculationMode:enum
 package: ExcelScript!

diff --git a/...elscript/excelscript.calculationstate.yml → ...elscript/excelscript.calculationstate.yml b/...elscript/excelscript.calculationstate.yml → ...elscript/excelscript.calculationstate.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.CalculationState
 uid: ExcelScript!ExcelScript.CalculationState:enum
 package: ExcelScript!

diff --git a/...celscript/excelscript.calculationtype.yml → ...celscript/excelscript.calculationtype.yml b/...celscript/excelscript.calculationtype.yml → ...celscript/excelscript.calculationtype.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.CalculationType
 uid: ExcelScript!ExcelScript.CalculationType:enum
 package: ExcelScript!

diff --git a/docs/docs-ref-autogen/excelscript/excelscript.cellcontrol.yml b/docs/docs-ref-autogen/excelscript/excelscript.cellcontrol.yml
@@ -0,0 +1,16 @@
+### YamlMime:TSTypeAlias
+name: ExcelScript.CellControl
+uid: ExcelScript!ExcelScript.CellControl:type
+package: ExcelScript!
+fullName: ExcelScript.CellControl
+summary: Represents an interactable control inside of a cell.
+remarks: "\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[ExcelScript.UnknownCellControl](/javascript/api/office-scripts/excelscript/excelscript.unknowncellcontrol), [ExcelScript.EmptyCellControl](/javascript/api/office-scripts/excelscript/excelscript.emptycellcontrol), [ExcelScript.MixedCellControl](/javascript/api/office-scripts/excelscript/excelscript.mixedcellcontrol), [ExcelScript.CheckboxCellControl](/javascript/api/office-scripts/excelscript/excelscript.checkboxcellcontrol)"
+
+isPreview: false
+isDeprecated: false
+syntax: |-
+  type CellControl =
+          | UnknownCellControl
+          | EmptyCellControl
+          | MixedCellControl
+          | CheckboxCellControl;
diff --git a/...celscript/excelscript.cellcontroltype.yml → ...celscript/excelscript.cellcontroltype.yml b/...celscript/excelscript.cellcontroltype.yml → ...celscript/excelscript.cellcontroltype.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.CellControlType
 uid: ExcelScript!ExcelScript.CellControlType:enum
 package: ExcelScript!

diff --git a/...xcelscript.cellvalueconditionalformat.yml → ...xcelscript.cellvalueconditionalformat.yml b/...xcelscript.cellvalueconditionalformat.yml → ...xcelscript.cellvalueconditionalformat.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.CellValueConditionalFormat
 uid: ExcelScript!ExcelScript.CellValueConditionalFormat:interface
 package: ExcelScript!

diff --git a/...n/excel/excelscript/excelscript.chart.yml → ...autogen/excelscript/excelscript.chart.yml b/...n/excel/excelscript/excelscript.chart.yml → ...autogen/excelscript/excelscript.chart.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.Chart
 uid: ExcelScript!ExcelScript.Chart:interface
 package: ExcelScript!

diff --git a/...celscript/excelscript.chartareaformat.yml → ...celscript/excelscript.chartareaformat.yml b/...celscript/excelscript.chartareaformat.yml → ...celscript/excelscript.chartareaformat.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.ChartAreaFormat
 uid: ExcelScript!ExcelScript.ChartAreaFormat:interface
 package: ExcelScript!

diff --git a/...cel/excelscript/excelscript.chartaxes.yml → ...gen/excelscript/excelscript.chartaxes.yml b/...cel/excelscript/excelscript.chartaxes.yml → ...gen/excelscript/excelscript.chartaxes.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.ChartAxes
 uid: ExcelScript!ExcelScript.ChartAxes:interface
 package: ExcelScript!

diff --git a/...cel/excelscript/excelscript.chartaxis.yml → ...gen/excelscript/excelscript.chartaxis.yml b/...cel/excelscript/excelscript.chartaxis.yml → ...gen/excelscript/excelscript.chartaxis.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.ChartAxis
 uid: ExcelScript!ExcelScript.ChartAxis:interface
 package: ExcelScript!

diff --git a/...ipt/excelscript.chartaxiscategorytype.yml → ...ipt/excelscript.chartaxiscategorytype.yml b/...ipt/excelscript.chartaxiscategorytype.yml → ...ipt/excelscript.chartaxiscategorytype.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.ChartAxisCategoryType
 uid: ExcelScript!ExcelScript.ChartAxisCategoryType:enum
 package: ExcelScript!

diff --git a/...ript/excelscript.chartaxisdisplayunit.yml → ...ript/excelscript.chartaxisdisplayunit.yml b/...ript/excelscript.chartaxisdisplayunit.yml → ...ript/excelscript.chartaxisdisplayunit.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSEnum
+### YamlMime:TSEnum
 name: ExcelScript.ChartAxisDisplayUnit
 uid: ExcelScript!ExcelScript.ChartAxisDisplayUnit:enum
 package: ExcelScript!

diff --git a/...celscript/excelscript.chartaxisformat.yml → ...celscript/excelscript.chartaxisformat.yml b/...celscript/excelscript.chartaxisformat.yml → ...celscript/excelscript.chartaxisformat.yml
@@ -1,4 +1,4 @@
-### YamlMime:TSType
+### YamlMime:TSType
 name: ExcelScript.ChartAxisFormat
 uid: ExcelScript!ExcelScript.ChartAxisFormat:interface
 package: ExcelScript!