Skip to main content

Insert Link

Inserts a hyperlink into a Google Docs document.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Document Id - The ID of the Google Docs document to insert a link into.
  • Link - The URL for the hyperlink.
  • Link Text - The display text for the hyperlink. If not provided, the Link URL will be used as the display text.
  • Font Size - The font size for the link text.
  • Font Name - The font family for the link text. Default is "Times New Roman".

Options​

  • Align - The alignment of the link text. Options are:
    • Left (START)
    • Center (CENTER)
    • Right (END)
    • Justify (JUSTIFIED)
  • Bold - Whether to make the link text bold. Default is false.
  • Italic - Whether to make the link text italic. Default is false.
  • Underline - Whether to underline the link text. Default is true.
  • Link Color (Red) - The red component of the link color (0.0 to 1.0). Default is 0.067.
  • Link Color (Green) - The green component of the link color (0.0 to 1.0). Default is 0.333.
  • Link Color (Blue) - The blue component of the link color (0.0 to 1.0). Default is 0.800.

How It Works​

The Insert Link node integrates with Google Docs to add a hyperlink to a document. When executed, the node:

  1. Validates the provided inputs (Document Id, Link, Font Size, Font Name)
  2. Connects to the specified Google Docs document
  3. Inserts the link text at the end of the document
  4. Applies the hyperlink to the inserted text
  5. Applies the specified formatting options (font, size, alignment, styling, color)

Requirements​

  • A valid Google Docs document ID
  • Valid Google Docs credentials
  • A valid URL for the hyperlink
  • Valid font size value
  • Valid Google Docs permissions to modify the document

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Document Id
  • Empty or invalid Link URL
  • Empty or invalid Font Size
  • Google Docs service errors
  • Insufficient permissions to modify the document

Usage Notes​

  • The Document Id can be found in the URL of the Google Docs document
  • If Link Text is not provided, the Link URL will be used as the display text
  • The link will be added at the end of the current document content
  • The default link color is a shade of blue (RGB: 0.067, 0.333, 0.800)
  • The Underline option is enabled by default for links, which is standard web convention
  • The link color values should be between 0.0 and 1.0