Skip to main content

How to Write an Add-on for Google Docs

Well, it ain’t that difficult. If you know some HTML, CSS and JavaScript, you can create a Google Docs add-on.

Create a Google Add-on for Docs & Sheets

This step-by-step tutorial (download) will walk you through the process of creating your own add-on for Google Docs. The add-on used in the demo lets you insert a image of any address on Google Maps inside a Google Document without requiring any screen capture software.
Ok, lets’s get going.
Step 1. Open a new document inside Google Drive and choose Tools -> Script Editor. This is the Apps Script IDE where we’ll write the code for the add-on.
Step 2. Choose File -> New HTML to create a new HTML file inside the Script Editor and name your file as googlemaps.html (or anything you like).
Step 3. Copy-paste the following code in the HTML file and save your changes. This is the code that will be used to render the sidebar in your Google Documents.
    

    2. 

  2.  href="https://ssl.gstatic.com/docs/script/css/add-ons.css"
    3. 

  3.      rel="stylesheet"> 
    4. 

  4.  
    5. 

    6. 

  6. 
 class="sidebar">
    

    7. 

  7.     
    8. 

  8.     
    9. 

  9.     
    
 class="block form-group">
    

    10. 

  10.          type="text" id="search" placeholder="Enter address.. " />
    11. 

  11.         
    12. 

  12.     
    13.
  • id='maps'>
  •  
  •  
  •  
    • Step 4. Next we will write the server side JavaScript (Google Script) that will actually render the sidebar and insert Google Maps images in the document.
      

    1. /* What should the add-on do after it is installed */
      2. 

    2. function onInstall() {
      3. 

    3.   onOpen();
      4. 

    4. }
      5. 

    5.  
      6. 

    6. /* What should the add-on do when a document is opened */
      7. 

    7. function onOpen() {
      8. 

    8.   DocumentApp.getUi()
      9. 

    9.   .createAddonMenu() // Add a new option in the Google Docs Add-ons Menu
      10. 

    10.   .addItem("Google Maps", "showSidebar")
      11. 

    11.   .addToUi();  // Run the showSidebar function when someone clicks the menu
      12. 

    12. }
      13. 

    13.  
      14. 

    14. /* Show a 300px sidebar with the HTML from googlemaps.html */
      15. 

    15. function showSidebar() {
      16. 

    16.   var html = HtmlService.createTemplateFromFile("googlemaps")
      17. 

    17.     .evaluate()
      18. 

    18.     .setTitle("Google Maps - Search"); // The title shows in the sidebar
      19. 

    19.   DocumentApp.getUi().showSidebar(html);
      20. 

    20. }
      21. 

    21.  
      22. 

    22. /* This Google Script function does all the magic. */
      23. 

    23. function insertGoogleMap(e) {  
      24. 

    24.   var map = Maps.newStaticMap()
      25. 

    25.     .setSize(800, 600) // Insert a Google Map 800x600 px
      26. 

    26.     .setZoom(15)
      27. 

    27.     .setCenter(e); // e contains the address entered by the user
      28. 

    28.   
      29. 

    29.   DocumentApp.getActiveDocument()
      30. 

    30.     .getCursor() // Find the location of the cursor in the document
      31. 

    31.     .insertInlineImage(map.getBlob()); // insert the image at the cursor
      32. 

    32. }
      33.
    Save your changes and then choose onOpen from the Run menu inside the Script editor. Authorize the script and switch to your Google Document.
    You’ll see a new Google Maps option under the Add-ons menu. Select the menu item and you’ll be able to insert maps images inside your Google Documents without using any screen capture software.

    Share your Google Add-ons with other Google Docs users

    Now that your first Google add-on is ready, you may want to distribute it to other users of Google Docs. The easiest option would be that you share your document with public and set the permission as Anyone can view. Now anyone can create a copy of your document in their own Google Drive and use your add-on.