Stay organized with collections Save and categorize content based on your preferences.
TextRangeA segment of the text contents of a Shape or a TableCell.
If you use methods that edit how the text fits within a shape, any autofit settings applied to the shape are deactivated.
Methods Method Return type Brief descriptionappendParagraph(text) Paragraph Appends a paragraph at the end of the text range. appendRange(textRange) TextRange Appends a copy of the provided text range to the end of the current text range. appendRange(textRange, matchSourceFormatting) TextRange Appends a copy of the provided text range to the end of the current text range. appendText(text) TextRange Appends text at the end of the text range. asRenderedString() String Returns the rendered text bounded by this range of the associated shape or table cell in a format appropriate to display to end users. asString() String Returns the raw text bounded by this range of the associated shape or table cell. clear() void Clears the text bounded by this range. clear(startOffset, endOffset) void Clears the text bounded by the start and end offsets in the range. find(pattern) TextRange[] Returns all the ranges matching the search pattern in the current text range. find(pattern, startOffset) TextRange[] Returns all the ranges matching the search pattern in the current text range starting from the start offset. getAutoTexts() AutoText[] Returns the auto texts within the current text range. getEndIndex() Integer Returns the exclusive, 0-based index for the last character in this range. getLength() Integer Returns the number of characters in this range. getLinks() TextRange[] Returns a collection of text ranges that correspond to all Links within the current text range or overlapping the current text range. getListParagraphs() Paragraph[] Returns the paragraphs in lists that overlap the current text range. getListStyle() ListStyle Returns the ListStyle of the current text range. getParagraphStyle() ParagraphStyle Returns the ParagraphStyle of the current text range. getParagraphs() Paragraph[] Returns the paragraphs that overlap the current text range. getRange(startOffset, endOffset) TextRange Returns a new TextRange covering part of the range from which it is derived. getRuns() TextRange[] Returns the text runs that overlap the current text range. getStartIndex() Integer Returns the inclusive, 0-based index for the first character in this range. getTextStyle() TextStyle Returns the text style of the range, or null if the range is empty. insertParagraph(startOffset, text) Paragraph Inserts a paragraph at the start offset. insertRange(startOffset, textRange) TextRange Inserts a copy of the provided text range at the start offset. insertRange(startOffset, textRange, matchSourceFormatting) TextRange Inserts a copy of the provided text range at the start offset. insertText(startOffset, text) TextRange Inserts text at the start offset. isEmpty() Boolean Returns true if there are no characters in this range, and returns false otherwise. replaceAllText(findText, replaceText) Integer Replaces all instances of text matching find text with replace text. replaceAllText(findText, replaceText, matchCase) Integer Replaces all instances of text matching find text with replace text. select() void Selects only the TextRange in the active presentation and removes any previous selection. setText(newText) TextRange Sets the text bounded by this range of the associated shape or table cell. Detailed documentation appendParagraph(text)
Appends a paragraph at the end of the text range. The paragraph maintains the styling of the end of the current text range.
The provided text string is appended as a paragraph by adding at least one surrounding newline character to the string.
When the provided text string contains newline characters (thus consisting of multiple paragraphs), the final paragraph added is returned.
Parameters Name Type Descriptiontext String The string to append as a paragraph. Return
Paragraph — The appended Paragraph.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsappendText(text)
Appends text at the end of the text range. The text maintains the styling of the end of the existing text.
Parameters Name Type Descriptiontext String The string to append. Return
TextRange — The text range representing the appended text.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsasRenderedString()
Returns the rendered text bounded by this range of the associated shape or table cell in a format appropriate to display to end users.
AutoText elements, such as generated slide numbers, are replaced with their rendered values. Any non-text elements in the range are omitted.
ReturnString — The rendered text in the range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsasString()
Returns the raw text bounded by this range of the associated shape or table cell.
AutoText elements such as generated slide numbers and any non-text elements in the range are replaced with the Unicode character U+E907.
ReturnString — The raw text in the range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsclear()
Clears the text bounded by this range.
Since the entire text in a Shape or TableCell must end in a newline, the final newline in the text is not removed.
AuthorizationScripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsclear(startOffset, endOffset)
Clears the text bounded by the start and end offsets in the range.
Since the text must end in a newline, the final newline in text is not removed even if it's covered by the given offsets.
Parameters Name Type DescriptionstartOffset Integer The number of characters past the start index of the current text range used to determine the inclusive start index of the range to clear. The start offset must be equal to or greater than 0 and less than or equal to endOffset. startOffset must also be less than the length of the current range. endOffset Integer The number of characters past the start index of the current text range used to determine the exclusive end index of the range to clear. The endOffset must be equal to or greater than startOffset. endOffset must also be less than or equal to the length of the current range. Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsfind(pattern)
Returns all the ranges matching the search pattern in the current text range. The search is case sensitive.
Parameters Name Type Descriptionpattern String The regular expression pattern to search; any backslashes in the pattern should be escaped. Return
TextRange[] — A list of text ranges.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsfind(pattern, startOffset)
Returns all the ranges matching the search pattern in the current text range starting from the start offset. The search is case sensitive.
Parameters Name Type Descriptionpattern String The regular expression pattern to search; any backslashes in the pattern should be escaped. startOffset Integer The number of characters past the start index of the current text range used to determine the inclusive start index of the range to search. startOffset must also be less than the length of the current range. Return
TextRange[] — A list of text ranges.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetAutoTexts()
Returns the auto texts within the current text range.
ReturnAutoText[] — A list of auto texts.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetEndIndex()
Returns the exclusive, 0-based index for the last character in this range. If the start and end indices are equal, the range is considered to be empty.
ReturnInteger — The end index of the range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetLength()
Returns the number of characters in this range.
ReturnInteger — The number of characters in this range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetLinks()
Returns a collection of text ranges that correspond to all Links within the current text range or overlapping the current text range.
Each returned range is guaranteed to span one link when it is created. Text modifications can cause it to no longer represent exactly one link.
Each Link on the returned ranges can be accessed via TextStyle.getLink().
// Accesses the first link on a TextRange object. const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText(); const linkTextRange = textRange.getLinks()[0]; const textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' const link = textStyle.getLink(); // Link objectReturn
TextRange[] — A list of text ranges.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetListParagraphs()
Returns the paragraphs in lists that overlap the current text range.
ReturnParagraph[] — A list of paragraphs in lists.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetListStyle()
Returns the ListStyle of the current text range.
ListStyle — The list style of the current text range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetParagraphStyle()
Returns the ParagraphStyle of the current text range.
ParagraphStyle — The paragraph style of the current text range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetParagraphs()
Returns the paragraphs that overlap the current text range.
ReturnParagraph[] — A list of paragraphs.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetRange(startOffset, endOffset)
Returns a new TextRange covering part of the range from which it is derived.
startOffset Integer The number of characters past the start index of the current text range used to determine the inclusive start index of the returned range. The start offset must be equal to or greater than 0 and less than or equal to endOffset. startOffset must also be less than the length of the current range. endOffset Integer The number of characters past the start index of the current text range used to determine the exclusive end index of the returned range. The endOffset must be equal to or greater than startOffset. endOffset must also be less than or equal to the length of the current range. Return
TextRange — A new text range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetRuns()
Returns the text runs that overlap the current text range. A text run is a segment of text where all the characters have the same text style.
Each returned range is only guaranteed to span one run when it is created. Text or style modifications can cause it to no longer represent exactly one run.
ReturnTextRange[] — A list of text ranges.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetStartIndex()
Returns the inclusive, 0-based index for the first character in this range. If the start and end indices are equal, the range is considered to be empty.
ReturnInteger — The start index of the range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsgetTextStyle()
Returns the text style of the range, or null if the range is empty.
TextStyle — The text style of the range.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertParagraph(startOffset, text)
Inserts a paragraph at the start offset. The paragraph maintains the styling of the current text range at the start offset.
The provided text string is inserted as a paragraph by adding at least one surrounding newline character to the string.
When the provided text string contains newline characters (thus consisting of multiple paragraphs), the final paragraph added is returned.
Parameters Name Type DescriptionstartOffset Integer The number of characters past the start index of the current text range used to determine the inclusive start index of the text to insert. text String The string to insert. Return
Paragraph — The inserted Paragraph.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsinsertText(startOffset, text)
Inserts text at the start offset. The text maintains the styling of the existing text at the start offset.
Parameters Name Type DescriptionstartOffset Integer The number of characters past the start index of the current text range used to determine the inclusive start index of the text to insert. text String The string to insert. Return
TextRange — The text range representing the inserted text.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsisEmpty()
Returns true if there are no characters in this range, and returns false otherwise.
Boolean — true if there are no characters in this range, and returns false otherwise.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsreplaceAllText(findText, replaceText)
Replaces all instances of text matching find text with replace text. The search is case insensitive.
Parameters Name Type DescriptionfindText String The text to find. replaceText String The text to replace the matched text. Return
Integer — the number of occurrences changed
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsreplaceAllText(findText, replaceText, matchCase)
Replaces all instances of text matching find text with replace text.
Parameters Name Type DescriptionfindText String The text to find. replaceText String The text to replace the matched text. matchCase Boolean If true, the search is case sensitive; if false, the search is case insensitive. Return
Integer — the number of occurrences changed
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsselect()
Selects only the TextRange in the active presentation and removes any previous selection.
A script can only access the selection of the user who is running the script, and only if the script is bound to the presentation.
The parent Page of the corresponding Shape or the TableCell is set as the current page selection. The Shape or the TableCell is set as the selected page element.
The
Selection
can be of two types:
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.getText().setText('Hello');
// Range selection: Select the text range "He".
shape.getText().getRange(0, 2).select();
// Cursor selection: Place the cursor after "H" like "H|ello".
shape.getText().getRange(1, 1).select(); Authorization
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationssetText(newText)
Sets the text bounded by this range of the associated shape or table cell. The text maintains the styling of the start of the existing text.
Parameters Name Type DescriptionnewText String The string to set as the new text. Return
TextRange — The text range representing the set text.
Scripts that use this method require authorization with one or more of the following scopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentationsExcept 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-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-04 UTC."],[[["`TextRange` objects represent segments of text within Google Slides shapes or table cells, allowing for manipulation and retrieval of text content and formatting."],["The `TextRange` functionality includes methods to add, insert, replace, clear, and retrieve text, as well as access styling information and elements like links and paragraphs."],["Most `TextRange` methods require authorization with specific Google API scopes related to presentations."],["Developers can use `TextRange` methods to programmatically edit and interact with text within Google Slides presentations."],["The provided methods offer extensive capabilities for working with text content and formatting within Google Slides, including searching, replacing, and styling text."]]],["`TextRange` represents a text segment within a shape or table cell. Key actions include: appending text/paragraphs with `appendText`, `appendParagraph`, and `appendRange`; inserting text/paragraphs with `insertText`, `insertParagraph`, and `insertRange`; deleting text with `clear`; finding text with `find`; replacing text with `replaceAllText`; retrieving text as displayed or raw strings with `asRenderedString` and `asString`. Additional functionality allows getting indexes, lengths, styles, paragraphs, lists, links, selecting the range with `select` and checking for emptiness. Every method requires specific authorization scopes.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4