toc.yml

items:
- name: Office Add-ins Documentation
  href: index.yml

- name: About Office Add-ins
  href: overview/office-add-ins.md
  displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook

- name: Get started
  items:
  - name: Beginner's guide
    href: overview/learning-path-beginner.md
    displayName: develop
  - name: Set up your development environment 
    href: overview/set-up-your-dev-environment.md
    displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
  - name: Quick starts
    items:
    - name: Excel add-in
      href: quickstarts/excel-quickstart-jquery.md
    - name: Excel custom functions
      href: quickstarts/excel-custom-functions-quickstart.md
    - name: OneNote add-in
      href: quickstarts/onenote-quickstart.md
    - name: Outlook add-in
      href: quickstarts/outlook-quickstart-yo.md
    - name: PowerPoint add-in
      href: quickstarts/powerpoint-quickstart-yo.md
    - name: Project add-in
      href: quickstarts/project-quickstart.md
    - name: Word add-in
      href: quickstarts/word-quickstart-yo.md
  - name: Explore Office JS APIs using Script Lab
    href: overview/explore-with-script-lab.md
    displayName: Excel, Word, PowerPoint
  - name: Samples
    href: overview/office-add-in-code-samples.md
    displayName: PnP, 'code samples'

- name: Development lifecycle
  items:
  - name: Lifecycle overview
    href: overview/core-concepts-office-add-ins.md
    displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook

  - name: Plan
    items:
    - name: Add-in development best practices
      href: concepts/add-in-development-best-practices.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: Office versions and requirement sets
      href: develop/office-versions-and-requirement-sets.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: Requirements for running add-ins
      href: concepts/requirements-for-running-office-add-ins.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: Install the latest Office version
      href: develop/install-latest-office-version.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: Browsers and webview controls used by Office Add-ins
      href: concepts/browsers-used-by-office-web-add-ins.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: Runtimes in Office Add-ins
      href: testing/runtimes.md
    - name: Support older Microsoft webviews and Office versions
      href: develop/support-ie-11.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: Manage both a unified manifest and an add-in only manifest version of your add-in
      href: concepts/duplicate-legacy-metaos-add-ins.md
      displayName: Excel, Word, PowerPoint, Outlook
  - name: Develop
    items:
    - name: Overview
      href: develop/develop-overview.md
      displayName: Excel, Word, OneNote, Project, PowerPoint, Outlook
    - name: API reference
      href: reference/javascript-api-for-office.md
    - name: Understanding the Office JavaScript API
      href: develop/understanding-the-javascript-api-for-office.md
    - name: Using the application-specific API model
      href: develop/application-specific-api-model.md
    - name: Using the Common API model
      items:
      - name: Common JavaScript API object model
        href: develop/office-javascript-api-object-model.md
      - name: Asynchronous programming in Office Add-ins
        href: develop/asynchronous-programming-in-office-add-ins.md
      - name: Support for content and task pane add-ins
        href: develop/support-for-task-pane-and-content-add-ins.md
      - name: Bind to regions in a document or spreadsheet
        href: develop/bind-to-regions-in-a-document-or-spreadsheet.md
    - name: Setup and run your add-in
      items:
      - name: Reference Office.js
        href: develop/referencing-the-javascript-api-for-office-library-from-its-cdn.md
      - name: Specify Office applications and API requirements
        items: 
        - name: Specify Office applications and API requirements with the unified manifest
          href: develop/specify-office-hosts-and-api-requirements-unified.md
        - name: Specify Office applications and API requirements with the add-in only manifest
          href: develop/specify-office-hosts-and-api-requirements.md
        - name: Understand and use platform-specific requirment sets
          href: develop/platform-specific-requirement-sets.md
        - name: Check for API availability at runtime
          href: develop/specify-api-requirements-runtime.md
      - name: Load sequence of an Office Add-in
        href: develop/loading-the-dom-and-runtime-environment.md
      - name: Initialize your add-in
        href: develop/initialize-add-in.md
        displayName: manifest
      - name: Automatically open a task pane with a document
        href: develop/automatically-open-a-task-pane-with-a-document.md
        displayName: manifest
      - name: Automatically open a task pane at add-in installation
        href: develop/automatically-open-on-installation.md
        displayName: manifest
      - name: Configure your add-in to use a shared runtime
        href: develop/configure-your-add-in-to-use-a-shared-runtime.md
      - name: Run code on document open
        href: develop/run-code-on-document-open.md
    - name: Manifest
      items:
      - name: Overview
        href: develop/add-in-manifests.md
      - name: Unified manifest for Microsoft 365
        items: 
        - name: Office Add-ins with the unified manifest for Microsoft 365
          href: develop/unified-manifest-overview.md
        - name: Compare the add-in only manifest with the unified manifest for Microsoft 365
          href: develop/json-manifest-overview.md
        - name: Convert an add-in to use the unified manifest for Microsoft 365
          href: develop/convert-xml-to-json-manifest.md
      - name: Add-in only manifest
        items:
        - name: Office Add-ins with the add-in only manifest
          href: develop/xml-manifest-overview.md
        - name: Add-in only manifest reference
          href: reference/manifest-reference.md
        - name: Find the proper order of manifest elements
          href: develop/manifest-element-ordering.md
        - name: Update API and manifest version
          href: develop/update-your-javascript-api-for-office-and-manifest-schema-version.md
          displayName: manifest
    - name: Privacy, security, and storage
      items:
      - name: Overview of add-in privacy and security
        href: concepts/privacy-and-security.md
      - name: Request permissions for API use in add-ins
        href: develop/requesting-permissions-for-api-use-in-content-and-task-pane-add-ins.md
      - name: ITP and third-party cookies
        href: develop/itp-and-third-party-cookies.md
      - name: Address same origin policy limitations
        href: develop/addressing-same-origin-policy-limitations.md
      - name: Wildcard trusted domains
        href: develop/trusted-domains.md
      - name: Persist state and settings
        href: develop/persisting-add-in-state-and-settings.md
    - name: Authentication and authorization
      items:
      - name: Overview
        href: develop/overview-authn-authz.md
      - name: Single sign-on with on-behalf-of flow
        items:
        - name: Enable SSO using on-behalf-of flow
          href: develop/sso-in-office-add-ins.md
        - name: Quick start
          href: quickstarts/sso-quickstart.md
        - name: Register with Microsoft identity platform
          href: develop/register-sso-add-in-aad-v2.md
        - name: Get the identity token
          href: develop/use-sso-to-get-office-signed-in-user-token.md
        - name: Authorize to Microsoft Graph
          href: develop/authorize-to-microsoft-graph.md
        - name: Create an SSO add-in using ASP.NET
          href: develop/create-sso-office-add-ins-aspnet.md
        - name: Create an SSO add-in using Node.js
          href: develop/create-sso-office-add-ins-nodejs.md
        - name: Troubleshoot error messages
          href: develop/troubleshoot-sso-in-office-add-ins.md
      - name: Enable SSO using nested app authentication
        href: develop/enable-nested-app-authentication-in-your-add-in.md
      - name: Office dialog API
        href: develop/auth-with-office-dialog-api.md      
      - name: Identity providers
        href: develop/auth-external-add-ins.md
      - name: Access Microsoft Graph
        href: develop/authorize-to-microsoft-graph-without-sso.md
    - name: UI and UX
      items:
      - name: Overview
        href: design/add-in-design.md
      - name: Fluent UI React in Office Add-ins
        href: quickstarts/fluent-react-quickstart.md
      - name: Fabric Core in Office Add-ins
        href: design/fabric-core.md
      - name: Guidelines
        items:
        - name: Accessibility
          href: design/accessibility-guidelines.md
        - name: Data visualization
          href: design/data-visualization-guidelines.md
        - name: Voice and tone
          href: design/voice-guidelines.md
      - name: UX design language and patterns
        items:
        - name: Design language
          items:
          - name: Overview
            href: design/add-in-design-language.md
          - name: Color
            href: design/add-in-color.md
          - name: Icons
            items:
            - name: Icon guidelines
              href: design/add-in-icons.md
            - name: Fresh style
              href: design/add-in-icons-fresh.md
            - name: Monoline style
              href: design/add-in-icons-monoline.md
          - name: Layout
            href: design/add-in-layout.md
          - name: Motion
            href: design/using-motion-office-addins.md
          - name: Typography
            href: design/add-in-typography.md
        - name: UX design patterns for common scenarios
          items:
          - name: Overview
            href: design/ux-design-pattern-templates.md
          - name: Authentication
            href: design/authentication-patterns.md
          - name: Branding
            href: design/branding-patterns.md
          - name: First-run experience
            items:
            - name: Overview
              href: design/first-run-experience-patterns.md
              displayName: first run experience
            - name: Tutorial
              href: tutorials/first-run-experience-tutorial.md
              displayName: first run experience
          - name: Navigation
            href: design/navigation-patterns.md
      - name: Interface elements
        items:
        - name: Overview
          href: design/interface-elements.md
        - name: Add-in commands
          items:
          - name: Basic concepts for Add-in Commands
            href: design/add-in-commands.md
          - name: Create add-in commands with the add-in only manifest
            href: develop/create-addin-commands.md
          - name: Create add-in commands with the unified manifest for Microsoft 365
            href: develop/create-addin-commands-unified-manifest.md
          - name: Create custom contextual tabs
            href: design/contextual-tabs.md
          - name: Change the availability of add-in commands
            href: design/disable-add-in-commands.md
          - name: Integrate built-in Office buttons into custom tabs
            href: design/built-in-button-integration.md
          - name: Position a custom tab on the ribbon
            href: design/custom-tab-placement.md
        - name: Content add-ins
          href: design/content-add-ins.md
        - name: Dialog boxes
          items:
          - name: Use the Office dialog API in your Office Add-ins
            href: develop/dialog-api-in-office-add-ins.md
          - name: Best practices and rules for the Office dialog API
            href: develop/dialog-best-practices.md
          - name: Send data from host page to dialog box
            href: develop/parent-to-dialog.md          
          - name: Handling errors and events in the Office dialog box
            href: develop/dialog-handle-errors-events.md
          - name: Use the Office dialog box to play a video
            href: develop/dialog-video.md
        - name: Task panes
          items:
          - name: Task panes in Office Add-ins
            href: design/task-pane-add-ins.md
          - name: Show or hide an Office Add-in task pane
            href: develop/show-hide-add-in.md
      - name: Keyboard shortcuts
        href: design/keyboard-shortcuts.md
      - name: Localization
        href: develop/localization.md
    - name: Frameworks, IDEs, and other tools
      items:
      - name: Create add-ins with the Office Add-ins Development Kit
        href: develop/development-kit-overview.md
      - name: Create add-ins with the Yeoman Generator
        href: develop/yeoman-generator-overview.md
      - name: Create add-ins with the Teams Toolkit
        href: develop/teams-toolkit-overview.md
      - name: Develop add-ins with Visual Studio Code
        href: develop/develop-add-ins-vscode.md
      - name: Create and Develop add-ins with Visual Studio
        items:
        - name: Overview
          href: develop/develop-add-ins-visual-studio.md
          displayName: Visual Studio
        - name: Get JavaScript IntelliSense in Visual Studio
          href: develop/get-javascript-intellisense-in-visual-studio.md
        - name: Convert JavaScript projects to TypeScript
          href: develop/convert-javascript-to-typescript.md
      - name: Copy Script Lab snippet to Yo Office
        href: overview/create-an-office-add-in-from-script-lab.md
        displayName: 'code samples'
      - name: Develop add-ins with Angular
        href: develop/add-ins-with-angular2.md
    - name: Special requirements for add-ins on the iPad
      href: develop/develop-office-add-ins-for-the-ipad.md
  - name: Test and debug
    items:
    - name: Test Office Add-ins
      href: testing/test-debug-office-add-ins.md
      displayName: test, debug
    - name: Debug Office Add-ins
      href: testing/debug-add-ins-overview.md
      displayName: debug
    - name: Windows
      items:
      - name: Sideload Office Add-ins that use the unified manifest for Microsoft 365
        href: testing/sideload-add-in-with-unified-manifest.md
      - name: Sideload Office Add-ins on Windows from a network share
        href: testing/create-a-network-shared-folder-catalog-for-task-pane-and-content-add-ins.md
      - name: Attach a debugger from the task pane
        href: testing/attach-debugger-from-task-pane.md
      - name: Debug using developer tools for Internet Explorer
        href: testing/debug-add-ins-using-f12-tools-ie.md
      - name: Debug using developer tools for Edge Legacy
        href: testing/debug-add-ins-using-devtools-edge-legacy.md
      - name: Debug using developer tools for Edge Chromium WebView2
        href: testing/debug-add-ins-using-devtools-edge-chromium.md
      - name: Debug using Visual Studio Code and Edge Chromium WebView2
        href: testing/debug-desktop-using-edge-chromium.md
      - name: Debug Office Add-ins in Visual Studio
        href: develop/debug-office-add-ins-in-visual-studio.md
      - name: Test with Trident
        href: testing/ie-11-testing.md
      - name: Unsupported window objects
        href: reference/window-objects-unsupported-in-add-ins.md
    - name: Web browser
      items:
      - name: Sideload Add-ins in Office on the web
        href: testing/sideload-office-add-ins-for-testing.md
      - name: Debug in Office on the web
        href: testing/debug-add-ins-in-office-online.md
    - name: iPad and Mac
      items:
      - name: Sideload Office Add-ins on Mac
        href: testing/sideload-an-office-add-in-on-mac.md
      - name: Sideload Office Add-ins on iPad
        href: testing/sideload-an-office-add-in-on-ipad.md
      - name: Debug on Mac
        href: testing/debug-office-add-ins-on-ipad-and-mac.md
    - name: Test and debug on a non-local server
      href: testing/test-debug-non-local-server.md
    - name: Clear the Office cache
      href: testing/clear-cache.md
      displayName: uninstall, sideload
    - name: Uninstall add-in under development
      href: testing/uninstall-add-in.md
      displayName: uninstall
    - name: Debug with runtime logging
      href: testing/runtime-logging.md
    - name: Debug a function command with a non-shared runtime
      href: testing/debug-function-command.md
    - name: Debug the initialize and onReady functions
      href: testing/debug-initialize-onready.md
    - name: Errors
      items:
      - name: Application-specific API error handling
        href: testing/application-specific-api-error-handling.md
      - name: Common API error codes
        href: reference/javascript-api-for-office-error-codes.md
      - name: Troubleshoot user errors
        href: testing/testing-and-troubleshooting.md
      - name: Troubleshoot development errors
        href: testing/troubleshoot-development-errors.md
    - name: Performance
      items:
      - name: Avoid using the context.sync method in loops
        href: concepts/correlated-objects-pattern.md
      - name: Resource limits and performance optimization for Office Add-ins
        href: concepts/resource-limits-and-performance-optimization.md
    - name: Unit testing
      href: testing/unit-testing.md
    - name: Usability testing
      href: develop/usability-testing.md
    - name: Validate an add-in's manifest
      href: testing/troubleshoot-manifest.md

  - name: Publish
    items:
    - name: Publish Office Add-ins
      href: publish/publish.md
    - name: Visual Studio Code
      items:
      - name: Deploy an add-in that uses static content
        href: publish/publish-add-in-vs-code.md
      - name: Deploy an add-in that uses SSO
        href: publish/deploy-office-add-in-sso-to-azure.md
    - name: Visual Studio
      items:
      - name: Publish your add-in (Visual Studio)
        href: publish/package-your-add-in-using-visual-studio.md
      - name: Stage an Office Add-in on Microsoft Azure with Visual Studio
        href: publish/host-an-office-add-in-on-microsoft-azure.md
      - name: Stage an Outlook add-in on Microsoft Azure with Visual Studio
        href: publish/stage-outlook-add-in-azure.md
    - name: Publish add-ins to AppSource
      href: publish/publish-office-add-ins-to-appsource.md
    - name: AppSource validation policies
      href: /legal/marketplace/certification-policies
    - name: Publish an add-in that requires admin consent
      href: publish/publish-nested-app-auth-add-in.md
    - name: Publish add-ins to a SharePoint app catalog
      href: publish/publish-task-pane-and-content-add-ins-to-an-add-in-catalog.md
    - name: Guidance for deploying on government clouds
      href: publish/government-cloud-guidance.md
    - name: Maintain your Office Add-in
      href: publish/maintain-breaking-changes.md
    - name: Trust custom protocol handlers to launch add-ins
      href: publish/custom-protocol-handler.md

- name: Excel
  items: 
  - name: Excel add-ins documentation
    href: excel/index.yml
    displayName: Excel
  - name: Overview
    href: excel/excel-add-ins-overview.md
    displayName: Excel
  - name: Build your first Excel add-in
    items:
    - name: Task pane
      href: quickstarts/excel-quickstart-jquery.md
      displayName: Excel
    - name: Task pane (React)
      href: quickstarts/excel-quickstart-react.md
      displayName: Excel
    - name: Content
      href: quickstarts/excel-quickstart-content.md
      displayName: Excel
  - name: Excel add-in tutorial
    href: tutorials/excel-tutorial.md
    displayName: Excel
  - name: 'Sample: Open in Excel'
    href: excel/pnp-open-in-excel.md
    displayName: Excel, 'code samples'
  - name: Excel JavaScript API
    items:
    - name: Overview
      href: reference/overview/excel-add-ins-reference-overview.md
      displayName: Excel
    - name: API reference
      href: reference/excel-api-reference.md
      displayName: Excel
    - name: Excel object model
      href: excel/excel-add-ins-core-concepts.md
      displayName: Excel
    - name: Blank and null values in Excel add-ins
      href: excel/excel-add-ins-blank-null-values.md
      displayName: Excel
    - name: Calling built-in functions
      href: excel/excel-add-ins-worksheet-functions.md
      displayName: Excel
    - name: Cells
      href: excel/excel-add-ins-cells.md
      displayName: Excel
    - name: Charts
      href: excel/excel-add-ins-charts.md
      displayName: Excel
    - name: Coauthoring in Excel add-ins
      href: excel/co-authoring-in-excel-add-ins.md
      displayName: Excel
    - name: Comments
      href: excel/excel-add-ins-comments.md
      displayName: Excel
    - name: Data types
      displayName: Excel
      items:
        - name: Overview
          href: excel/excel-data-types-overview.md
          displayName: Excel
        - name: Concepts
          href: excel/excel-data-types-concepts.md
          displayName: Excel
        - name: Entity value cards
          href: excel/excel-data-types-entity-card.md
          displayName: Excel
    - name: Data validation
      href: excel/excel-add-ins-data-validation.md
      displayName: Excel
    - name: Events
      href: excel/excel-add-ins-events.md
      displayName: Excel
    - name: Performance optimization
      href: excel/performance.md
      displayName: Excel
    - name: PivotTables
      href: excel/excel-add-ins-pivottables.md
      displayName: Excel
    - name: Ranges and cells
      items:
      - name: Get a range 
        href: excel/excel-add-ins-ranges-get.md
        displayName: Excel
      - name: Insert a range of cells
        href: excel/excel-add-ins-ranges-insert.md
        displayName: Excel
      - name: Clear or delete a range of cells
        href: excel/excel-add-ins-ranges-clear-delete.md
        displayName: Excel
      - name: Set or get the selected range 
        href: excel/excel-add-ins-ranges-set-get.md
        displayName: Excel
      - name: Set or get values, text, or formulas
        href: excel/excel-add-ins-ranges-set-get-values.md
        displayName: Excel
      - name: Set range format 
        href: excel/excel-add-ins-ranges-set-format.md
        displayName: Excel
      - name: Conditional formatting of ranges
        href: excel/excel-add-ins-conditional-formatting.md
        displayName: Excel
      - name: Read or write to an unbounded range
        href: excel/excel-add-ins-ranges-unbounded.md
        displayName: Excel
      - name: Read or write to a large range
        href: excel/excel-add-ins-ranges-large.md
        displayName: Excel
      - name: Find a cell using string matching
        href: excel/excel-add-ins-ranges-string-match.md
        displayName: Excel
      - name: Work with dates using the Moment-MSDate plug-in
        href: excel/excel-add-ins-ranges-dates.md
        displayName: Excel
      - name: Find special cells within a range
        href: excel/excel-add-ins-ranges-special-cells.md
        displayName: Excel
      - name: Cut, copy, and paste
        href: excel/excel-add-ins-ranges-cut-copy-paste.md
        displayName: Excel
      - name: Remove duplicates
        href: excel/excel-add-ins-ranges-remove-duplicates.md
        displayName: Excel
      - name: Group data for an outline
        href: excel/excel-add-ins-ranges-group.md
        displayName: Excel
      - name: Handle dynamic arrays and spilling
        href: excel/excel-add-ins-ranges-dynamic-arrays.md
        displayName: Excel
      - name: Get formula precedents and dependents
        href: excel/excel-add-ins-ranges-precedents-dependents.md
        displayName: Excel
      - name: Delay execution while cell is being edited
        href: excel/excel-add-ins-delay-in-cell-edit.md
        displayName: Excel
      - name: Work with multiple ranges
        href: excel/excel-add-ins-multiple-ranges.md
        displayName: Excel
    - name: Shapes
      href: excel/excel-add-ins-shapes.md
      displayName: Excel
    - name: Tables
      href: excel/excel-add-ins-tables.md
      displayName: Excel
    - name: Workbooks
      href: excel/excel-add-ins-workbooks.md
      displayName: Excel
    - name: Worksheets
      href: excel/excel-add-ins-worksheets.md
      displayName: Excel
    - name: Worksheet display
      href: excel/excel-add-ins-worksheet-display.md
      displayName: Excel
    - name: Troubleshoot Excel add-ins
      href: excel/excel-add-ins-troubleshooting.md
      displayName: Excel      
  - name: Custom functions
    items:
    - name: Overview
      href: excel/custom-functions-overview.md
      displayName: Excel, Custom Functions
    - name: Tutorials
      items:
      - name: Build your first custom functions add-in
        href: quickstarts/excel-custom-functions-quickstart.md
        displayName: Excel, Custom Functions
      - name: Custom functions tutorial
        href: tutorials/excel-tutorial-create-custom-functions.md
        displayName: Excel, Custom Functions
      - name: Share custom function data with the task pane
        href: tutorials/share-data-and-events-between-custom-functions-and-the-task-pane-tutorial.md
        displayName: Excel, Custom Functions
    - name: Best practices
      href: excel/custom-functions-get-started.md
      displayName: Excel, Custom Functions
    - name: Naming and localization
      href: excel/custom-functions-naming.md
      displayName: Excel, Custom Functions
    - name: Parameter options
      href: excel/custom-functions-parameter-options.md
      displayName: Excel, Custom Functions
    - name: Error handling
      href: excel/custom-functions-errors.md
      displayName: Excel, Custom Functions
    - name: Autogenerate JSON metadata
      href: excel/custom-functions-json-autogeneration.md
      displayName: Excel, Custom Functions
    - name: Manually create JSON metadata
      href: excel/custom-functions-json.md
      displayName: Excel, Custom Functions
    - name: Call Excel JavaScript APIs
      href: excel/call-excel-apis-from-custom-function.md
      displayName: Excel, Custom Functions
    - name: Data types
      href: excel/custom-functions-data-types-concepts.md
      displayName: Excel, Custom Functions
    - name: Batch custom function remote calls
      href: excel/custom-functions-batching.md
      displayName: Excel, Custom Functions
    - name: Extend custom functions with XLL add-ins
      href: excel/make-custom-functions-compatible-with-xll-udf.md
      displayName: Excel, Custom Functions
    - name: Return a dynamic array
      href: excel/custom-functions-dynamic-arrays.md
      displayName: Excel, Custom Functions
    - name: Volatile functions
      href: excel/custom-functions-volatile.md
      displayName: Excel, Custom Functions
    - name: Web requests
      href: excel/custom-functions-web-reqs.md
      displayName: Excel, Custom Functions
    - name: Custom functions without a shared runtime
      items: 
        - name: Authentication
          href: excel/custom-functions-authentication.md
          displayName: Excel, Custom Functions
        - name: JavaScript-only runtime for custom functions
          href: excel/custom-functions-runtime.md
          displayName: Excel, Custom Functions
        - name: Debugging
          href: excel/custom-functions-debugging.md
          displayName: Excel, Custom Functions
    - name: Troubleshoot custom functions
      href: excel/custom-functions-troubleshooting.md
      displayName: Excel, Custom Functions

- name: OneNote
  items:
  - name: OneNote add-ins documentation
    href: onenote/index.yml
    displayName: OneNote
  - name: Overview
    href: onenote/onenote-add-ins-programming-overview.md
    displayName: OneNote
  - name: Build your first OneNote add-in
    href: quickstarts/onenote-quickstart.md
    displayName: OneNote
  - name: OneNote JavaScript API
    items:
    - name: Overview
      href: reference/overview/onenote-add-ins-javascript-reference.md
      displayName: OneNote
    - name: API reference
      href: reference/onenote-api-reference.md
      displayName: OneNote
    - name: Work with OneNote page content
      href: onenote/onenote-add-ins-page-content.md
      displayName: OneNote

- name: Outlook
  items:
  - name: Outlook add-ins documentation
    href: outlook/index.yml
    displayName: Outlook
  - name: Overview
    href: outlook/outlook-add-ins-overview.md
    displayName: Outlook
  - name: Build your first Outlook add-in
    href: quickstarts/outlook-quickstart-yo.md
    displayName: Outlook
  - name: Outlook add-in tutorial
    href: tutorials/outlook-tutorial.md
    displayName: Outlook
  - name: Develop Outlook add-ins for the new Outlook on Windows
    href: outlook/one-outlook.md
  - name: Outlook JavaScript API
    displayName: Outlook
    items:
    - name: Overview
      href: outlook/apis.md
      displayName: Outlook
    - name: Mailbox requirement set
      href: /javascript/api/requirement-sets/outlook/outlook-api-requirement-sets
      displayName: Outlook
    - name: API reference - latest release
      href: reference/outlook-api-reference-latest.md
      displayName: Outlook
    - name: Add-in requirements
      href: outlook/add-in-requirements.md
    - name: Outlook add-in design guidelines
      href: outlook/outlook-addin-design.md
    - name: Event-based activation
      items:
      - name: Implement an event-based add-in
        href: outlook/autolaunch.md
        displayName: event-based activation
      - name: Implement Smart Alerts to handle on-send events
        href: outlook/onmessagesend-onappointmentsend-events.md
        displayName: event-based activation
      - name: Set the subject of a new mail item
        href: outlook/on-new-compose-events-walkthrough.md
        displayName: event-based activation
      - name: Check for an attachment before a message is sent
        href: outlook/smart-alerts-onmessagesend-walkthrough.md
        displayName: event-based activation
      - name: Update your signature when switching between accounts
        href: outlook/onmessagefromchanged-onappointmentfromchanged-events.md
        displayName: event-based activation
      - name: Troubleshoot event-based and spam-reporting add-ins
        href: outlook/troubleshoot-event-based-and-spam-reporting-add-ins.md
      - name: AppSource options
        href: outlook/autolaunch-store-options.md
        displayName: event-based activation
    - name: Implement a spam reporting add-in
      href: outlook/spam-reporting.md
    - name: Activate add-in without Reading Pane or selected message
      href: outlook/contextless.md
    - name: Item multi-select
      href: outlook/item-multi-select.md
    - name: Pinnable task pane
      href: outlook/pinnable-taskpane.md
    - name: Prepend or append content on send
      href: outlook/append-on-send.md
    - name: Shared folders and shared mailboxes
      href: outlook/delegate-access.md
      displayName: delegate access
    - name: Add-ins for Outlook on mobile devices
      items:
      - name: Overview
        href: outlook/outlook-mobile-addins.md
        displayName: outlook, add-ins, mobile
      - name: Add support for Outlook on mobile devices
        href: outlook/add-mobile-support.md
        displayName: outlook, add-ins, mobile
      - name: Outlook JavaScript API support on mobile devices
        href: outlook/outlook-mobile-apis.md
        displayName: outlook, add-ins, mobile
      - name: Log appointment notes on mobile
        href: outlook/mobile-log-appointments.md
        displayName: outlook, add-ins, mobile
      - name: Event-based activation in Outlook on mobile devices
        href: outlook/mobile-event-based.md
        displayName: outlook, add-ins, mobile, event-based activation
    - name: Create an online meeting add-in
      href: outlook/online-meeting.md
    - name: Contextual add-ins
      items:
      - name: Overview
        href: outlook/contextual-outlook-add-ins.md
      - name: Troubleshoot contextual add-in activation
        href: outlook/troubleshoot-outlook-add-in-activation.md
    - name: Module extension add-ins
      href: outlook/extension-module-outlook-add-ins.md
    - name: On-send add-ins
      href: outlook/outlook-on-send-addins.md
    - name: Call Outlook REST APIs
      href: outlook/use-rest-api.md
    - name: Call Exchange web services
      href: outlook/web-services.md
    - name: Get or set categories
      href: outlook/categories.md
    - name: Get or set internet headers
      href: outlook/internet-headers.md
    - name: Get or set recurrence
      href: outlook/get-and-set-recurrence.md
    - name: Get or set add-in metadata
      href: outlook/metadata-for-an-outlook-add-in.md
    - name: Read scenario
      items:
      - name: Overview
        href: outlook/read-scenario.md
      - name: Get attachments from server
        href: outlook/get-attachments-of-an-outlook-item.md
    - name: Compose scenario
      items:
      - name: Overview
        href: outlook/compose-scenario.md
      - name: Add and remove attachments
        href: outlook/add-and-remove-attachments-to-an-item-in-a-compose-form.md
      - name: Get and set recipients
        href: outlook/get-set-or-add-recipients.md
      - name: Insert data in the body
        href: outlook/insert-data-in-the-body.md
      - name: Get and set subject
        href: outlook/get-or-set-the-subject.md
      - name: Get and set times
        href: outlook/get-or-set-the-time-of-an-appointment.md
      - name: Get and set location
        href: outlook/get-or-set-the-location-of-an-appointment.md
      - name: Manage sensitivity labels
        href: outlook/sensitivity-label.md
      - name: Manage delivery time of a message
        href: outlook/delay-delivery.md
    - name: Privacy and security
      items:
      - name: Overview
        href: outlook/privacy-and-security.md
      - name: Understanding add-in permissions
        href: outlook/understanding-outlook-add-in-permissions.md
    - name: Authentication
      items:
      - name: Overview
        href: outlook/authentication.md
      - name: Authenticate with SSO token
        href: outlook/authenticate-a-user-with-an-sso-token.md
      - name: SSO and CORS in event-based or spam-reporting add-ins
        href: outlook/use-sso-in-event-based-activation.md
      - name: Authenticate with an identity token
        href: outlook/authenticate-a-user-with-an-identity-token.md
      - name: Validate an identity token
        href: outlook/validate-an-identity-token.md
      - name: Inside the identity token
        href: outlook/inside-the-identity-token.md
      - name: "Scenario: Implement single sign-on"
        href: outlook/implement-sso-in-outlook-add-in.md
      - name: Legacy token deprecation FAQ 
        href: outlook/faq-nested-app-auth-outlook-legacy-tokens.md
      - name: Turn legacy tokens on or off
        href: outlook/turn-exchange-tokens-on-off.md  
    - name: Testing and tips
      items:
      - name: Overview
        href: outlook/testing-and-tips.md
      - name: Sideload an add-in for testing
        href: outlook/sideload-outlook-add-ins-for-testing.md
      - name: Limits for activation and JavaScript API
        href: outlook/limits-for-activation-and-javascript-api-for-outlook-add-ins.md
      - name: Compare add-in support in Outlook on Mac
        href: outlook/compare-outlook-add-in-support-in-outlook-for-mac.md
      - name: Debug function commands
        href: outlook/debug-ui-less.md
      - name: Troubleshoot event-based and spam-reporting add-ins
        href: outlook/troubleshoot-event-based-and-spam-reporting-add-ins.md
      - name: Debug event-based and spam-reporting add-ins
        href: outlook/debug-autolaunch.md
      - name: Tips for handling date values
        href: outlook/tips-for-handling-date-values-in-outlook-add-ins.md

- name: PowerPoint
  items:
  - name: PowerPoint add-ins documentation
    href: powerpoint/index.yml
    displayName: PowerPoint
  - name: Overview
    href: powerpoint/powerpoint-add-ins.md
    displayName: PowerPoint
  - name: Build your first PowerPoint add-in
    items:
    - name: Task pane
      href: quickstarts/powerpoint-quickstart-yo.md
      displayName: PowerPoint
    - name: Content
      href: quickstarts/powerpoint-quickstart-content.md
      displayName: PowerPoint
  - name: PowerPoint add-in tutorial
    href: tutorials/powerpoint-tutorial-yo.md
    displayName: PowerPoint
  - name: JavaScript API for PowerPoint
    items:
    - name: Overview
      href: reference/overview/powerpoint-add-ins-reference-overview.md
      displayName: PowerPoint
    - name: API reference
      href: reference/powerpoint-api-reference.md
      displayName: PowerPoint
    - name: Add and delete slides
      href: powerpoint/add-slides.md
      displayName: PowerPoint
    - name: Insert slides
      href: powerpoint/insert-slides-into-presentation.md
      displayName: PowerPoint
    - name: Get the whole document from an add-in
      href: develop/get-the-whole-document-from-an-add-in-for-powerpoint-or-word.md
      displayName: PowerPoint
    - name: Use custom tags on presentations, slides, and shapes
      href: powerpoint/tagging-presentations-slides-shapes.md
      displayName: PowerPoint 
    - name: Use document themes in your PowerPoint add-ins
      href: powerpoint/use-document-themes-in-your-powerpoint-add-ins.md
      displayName: PowerPoint
    - name: Work with tables
      href: powerpoint/work-with-tables.md
      displayName: PowerPoint
    - name: Work with shapes
      href: powerpoint/shapes.md
      displayName: PowerPoint
    - name: Bind shapes to a data source
      href: powerpoint/bind-shapes-in-presentation.md
      displayName: PowerPoint
- name: Project
  items:
  - name: Project add-ins documentation
    href: project/index.yml
    displayName: Project
  - name: Overview
    href: project/project-add-ins.md
    displayName: Project
  - name: Build your first Project add-in
    href: quickstarts/project-quickstart.md
    displayName: Project
  - name: Create a Project add-in that uses REST with an on-premises OData service
    href: project/create-a-project-add-in-that-uses-rest-with-an-on-premises-odata-service.md
    displayName: Project

- name: Visio
  items:
  - name: Visio documentation
    href: visio/index.yml
    displayName: Visio
  - name: Overview
    href: reference/overview/visio-javascript-reference-overview.md
    displayName: Visio
  - name: API reference
    href: reference/visio-api-reference.md
    displayName: Visio

- name: Word
  items:
  - name: Word add-ins documentation
    href: word/index.yml
    displayName: Word
  - name: Overview
    href: word/word-add-ins-programming-overview.md
    displayName: Word
  - name: Build your first Word add-in
    href: quickstarts/word-quickstart-yo.md
    displayName: Word
  - name: Word add-in tutorial
    href: tutorials/word-tutorial.md
    displayName: Word
  - name: 'Sample: Import template'
    href: word/import-template.md
    displayName: Word
  - name: 'Sample: Manage citations'
    href: word/citation-management.md
    displayName: Word
  - name: Word JavaScript API
    items:
    - name: Overview
      href: reference/overview/word-add-ins-reference-overview.md
      displayName: Word
    - name: API reference
      href: reference/word-api-reference.md
      displayName: Word
    - name: Word object model
      href: word/word-add-ins-core-concepts.md
      displayName: Word
    - name: Dictionary task pane add-ins
      href: word/dictionary-task-pane-add-ins.md
      displayName: Word
    - name: Get the whole document from an add-in
      href: develop/get-the-whole-document-from-an-add-in-for-powerpoint-or-word.md
      displayName: Word
    - name: Read and write data to the active selection
      href: develop/read-and-write-data-to-the-active-selection-in-a-document-or-spreadsheet.md
      displayName: Word
    - name: Use fields
      href: word/fields-guidance.md
      displayName: Word
    - name: Use search options to find text
      href: word/search-option-guidance.md
      displayName: Word
    - name: Use events
      href: word/word-add-ins-events.md
      displayName: Word
    - name: When and how to use Office Open XML
      href: word/create-better-add-ins-for-word-with-office-open-xml.md
      displayName: Word
    - name: Troubleshoot Word add-ins
      href: word/word-add-ins-troubleshooting.md
      displayName: Word
- name: Transition from VSTO and COM
  items: 
  - name: VSTO add-in developers' guide to Office Add-ins
    href: overview/learning-path-transition.md
  - name: Quick starts
    items:
    - name: Excel
      items:
      - name: Task pane
        href: quickstarts/excel-quickstart-vs.md
        displayName: Excel
      - name: Content
        href: quickstarts/excel-quickstart-content.md
        displayName: Excel
    - name: Outlook
      href: quickstarts/outlook-quickstart-vs.md
      displayName: Outlook
    - name: PowerPoint 
      items:
      - name: Task pane
        href: quickstarts/powerpoint-quickstart-vs.md
        displayName: PowerPoint
      - name: Content
        href: quickstarts/powerpoint-quickstart-content.md
        displayName: PowerPoint
    - name: Word
      href: quickstarts/word-quickstart-vs.md
      displayName: Word
  - name: Work with a PowerPoint presentation
    href: tutorials/powerpoint-tutorial-vs.md
  - name: Share code from VSTO Add-in to Office Add-in
    href: tutorials/migrate-vsto-to-office-add-in-shared-code-library-tutorial.md
  - name: Make your Office Add-in compatible with an existing COM add-in
    href: develop/make-office-add-in-compatible-with-existing-com-add-in.md
    displayName: manifest
- name: Resources
  items:
  - name: GitHub Copilot prompt library
    href: resources/resources-github-copilot-prompt-library.md
    displayName: Excel, Word, PowerPoint
  - name: Glossary
    href: resources/resources-glossary.md
    displayName: Excel, Word, OneNote, Project, PowerPoint, Visio, Outlook
  - name: External resources
    href: resources/resources-links-help.md
    displayName: Excel, Word, OneNote, Project, PowerPoint, Visio, Outlook
  - name: Office Add-ins community call
    href: overview/office-add-ins-community-call.md