Extending Google Docs with add-ons
Stay organized with collections
Save and categorize content based on your preferences.
Google Docs is a cloud-based document
solution with real-time collaboration and powerful tools to compose, edit,
and share documents.
You can extend Docs with add-ons that build customized workflow improvements,
establish connectivity to third-party systems, and integrate your documents
with other Google Workspace applications (like
Google Slides).
You can see the Docs add-on others have built on the
Google Workspace Marketplace.
What you can do
Here are a few things you can do with an add-on that extends Google Docs:
- You can read, edit, visualize, and format text in Google Docs using the
built-in Apps Script Document service. The
service also lets you create and modify tables, images, drawings, and
equations appearing in Google Docs.
- You can create custom menus and
define multiple custom dialogs and sidebars
interfaces using standard HTML and CSS.
- You can use add-on triggers to run specified functions when
certain triggering events occur.
Docs add-ons are built using Apps Script. To learn more about how to access
and manage Google Docs with Apps Script, see
Extending Google Docs.
Document structure
The documents created in Google Docs have internal, tree-like structures
(similar to HTML or JSON) that define where and how text, images, tables, and
other elements appear. The Apps Script
Document service defines several
classes (such as Paragraph
or Table
) to help manage the
different element types.
See Structure of a document
to learn about these element classes and the rules that govern their
arrangement.
Triggers
Apps Script triggers let a script project execute a specified function
when certain conditions are met, such as when a document is opened or when an
add-on is installed.
See add-on triggers for more information
on what triggers can be used with Docs add-ons and what restrictions apply to
their use.
Getting started
When you're ready to take a look at some code, check out our
add-on samples, including the
Docs add-on Quickstart
featuring Google Translate.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eGoogle Docs is a cloud-based document solution enabling real-time collaboration and offering robust tools for composing, editing, and sharing documents.\u003c/p\u003e\n"],["\u003cp\u003eDocs add-ons, built using Apps Script, extend functionality by enabling workflow customization, integration with third-party systems, and connectivity with other Google Workspace applications.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons can manipulate document content, create custom interfaces, and automate tasks through triggers based on specific events.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides comprehensive documentation and resources, including code samples, to guide developers in building Docs add-ons.\u003c/p\u003e\n"]]],["Google Docs is a cloud-based document solution that can be extended with add-ons via Apps Script. These add-ons can read, edit, visualize, and format text, create custom menus and dialogs, and integrate with other Google Workspace applications. Add-ons utilize Apps Script triggers to run functions when specific events occur. The documents' tree-like structure is managed through the Apps Script Document service. Resources are available, including add-on samples and a quickstart guide, to help begin developing.\n"],null,["# Extending Google Docs with add-ons\n\n[Google Docs](https://workspace.google.com/products/docs/) is a cloud-based document\nsolution with real-time collaboration and powerful tools to compose, edit,\nand share documents.\n\nYou can extend Docs with add-ons that build customized workflow improvements,\nestablish connectivity to third-party systems, and integrate your documents\nwith other Google Workspace applications (like\nGoogle Slides).\n\nYou can see the Docs add-on others have built on the\n[Google Workspace Marketplace](https://workspace.google.com/marketplace/category/works-with-doc).\n\nWhat you can do\n---------------\n\nHere are a few things you can do with an add-on that extends Google Docs:\n\n- You can read, edit, visualize, and format text in Google Docs using the built-in Apps Script [Document service](/apps-script/reference/document). The service also lets you create and modify tables, images, drawings, and equations appearing in Google Docs.\n- You can create [custom menus](/workspace/add-ons/concepts/menus) and define multiple [custom dialogs and sidebars](/workspace/add-ons/concepts/dialogs) interfaces using standard HTML and CSS.\n- You can use add-on [triggers](#triggers) to run specified functions when certain triggering events occur.\n\nDocs add-ons are built using Apps Script. To learn more about how to access\nand manage Google Docs with Apps Script, see\n[Extending Google Docs](/apps-script/guides/docs).\n\nDocument structure\n------------------\n\nThe documents created in Google Docs have internal, tree-like structures\n(similar to HTML or JSON) that define where and how text, images, tables, and\nother elements appear. The Apps Script\n[Document service](/apps-script/reference/document) defines several\nclasses (such as [`Paragraph`](/apps-script/reference/document/paragraph)\nor [`Table`](/apps-script/reference/document/table)) to help manage the\ndifferent element types.\n\nSee [Structure of a document](/apps-script/guides/docs#structure_of_a_document)\nto learn about these element classes and the rules that govern their\narrangement.\n\nTriggers\n--------\n\nApps Script **triggers** let a script project execute a specified function\nwhen certain conditions are met, such as when a document is opened or when an\nadd-on is installed.\n\nSee [add-on triggers](/workspace/add-ons/concepts/editor-triggers) for more information\non what triggers can be used with Docs add-ons and what restrictions apply to\ntheir use.\n\nGetting started\n---------------\n\nWhen you're ready to take a look at some code, check out our\n[add-on samples](/workspace/add-ons/samples), including the\n[Docs add-on Quickstart](/workspace/add-ons/editors/docs/quickstart/translate)\nfeaturing Google Translate."]]