Skip to main content
googleSheets.formatRange() merges the format properties you provide into every cell in a grid range or native-table section.

Example

Inputs

Provide spreadsheet, range, and format. A grid range takes sheet plus optional one-based inclusive startRow, endRow, startColumn, and endColumn. A table target takes table and optional section: all, header, body, or footer. The section defaults to all. Requesting a missing body or footer fails. format accepts:
  • backgroundColor: a six-digit hex color such as #1A73E8, or { theme } where theme is text, background, accent1 through accent6, or link
  • text: family, integer size, bold, italic, strikethrough, underline, link, and color
  • borders: top, right, bottom, left, innerHorizontal, and innerVertical. Each is null to clear it or { style, color? }, where style is dotted, dashed, solid, solidMedium, solidThick, or double
  • horizontalAlignment: left, center, or right. verticalAlignment accepts top, middle, or bottom
  • wrap: overflow, clip, or wrap. textDirection accepts leftToRight or rightToLeft. hyperlinkDisplay accepts linked or plainText
  • padding: integer top, right, bottom, and left pixel values. Google requires all four sides
  • rotation: { type: "angle", angle } with an integer from -90 through 90, or { type: "vertical", vertical: boolean }
  • numberFormat: optional Sheets pattern and type: text, number, percent, currency, date, time, dateTime, or scientific
Automate.ax validates colors and enum values before sending the request to Google. Second argument { account } selects the Google Account. All action inputs accept compatible signals.

Output

Returns the resolved zero-based, end-exclusive grid range with numeric sheetId. Unspecified formatting remains unchanged.