Word actions

The Word automation feature enables you to seamlessly interact with Word files stored either locally or in the cloud. To begin, you need to create a Word instance using either the 'Launch Word' or 'Attach to running Word' action. This instance serves as the input parameter for the rest of the actions in the group, allowing you to easily perform actions on the desired Word file.

Currently, the below actions are available:

• Launch Word: When this action is triggered in Power Automate for desktop, it opens a Word document and creates a Word instance that can be used in subsequent Word actions within the same desktop flow. The user can choose to open either a new, blank Word document or an existing one located on the local machine or in the cloud (through OneDrive or SharePoint). Depending on the action's configuration, the Word application can be launched visibly or invisibly, and the document can be opened in read-only mode. It's important to note that if the document is opened in read-only mode, it can't be edited either through Power Automate for desktop actions or manually.
• Attach to running Word: This action provides the capability to attach an existing Word document that's currently open and creates a Word instance that can be used in subsequent Word actions within the same desktop flow. The user has the option to insert a Word document that's already open on the same machine at the time of design through a drop-down menu, or select an existing Word document located on the local machine or in the cloud (through OneDrive or SharePoint).
• Save Word: This action enables the user to save a Word document in any format that currently the Word application supports. The default document format is 'Default (From Extension)' which means that the user must set the document format in the Document path parameter, such as set the value to C:\TestWord.pdf to save it as PDF.
• Close Word: This action closes a Word document and make the specific Word instance in Power Automate as inactive. The user can save the Word document before closing it in any format that currently the Word application supports. Note that the default document format is 'Default (From Extension)' which means that the user must set the document format in the 'Document path' parameter, such as set the value to C:\TestWord.pdf to save it as PDF.
• Read from Word document: This action enables users to retrieve content from a Word document and use it in a subsequent action of the flow. You have the flexibility to read the entire document, specific pages, or the content of a bookmark. For pages, you can specify a specific page or a list of pages. For example, you can insert the value 2-5 in the respective Pages parameter to retrieve the content of pages two to five, for example pages 2, 3, 4, and 5, or insert the value 3,5,6,7 to retrieve the content of the respective pages or use a combination of both ways, such as 2-4,6,8,9. It's important to note that the Word document format can't be retrieved, and the output parameter is in plain text.
• Find and replace words in Word document: Users can apply a new functionality with this action, which is the ability to find and replace specific text within a Word document. Users have the option to replace only the first occurrence of the text or all matches. Additionally, the use of wildcards allows for dynamic text finding, with the wildcard being inserted in the Text to find input parameter. To further refine the search, configure the tool to match the case of the text or match whole words only. These settings are available when the Use wildcards parameter is set to off.
• Write to Word document: This action enables users to insert text in specific positions within a Word document. This can be done at the beginning or end of the file, or before or after a specific bookmark. Additionally, users have the option to append a new line before the inserted text or not, depending on their preferences.
• Insert image in Word document: This action allows users to insert images in specific positions within a Word document. This can be done at the beginning or end of the file, before or after a specific bookmark, or before or after specific text. Note that no spaces or new lines are added. Users have the option to retrieve the image either as a file stored in their local machine or as content from the clipboard.

Note

Word actions in Power Automate for desktop are compatible with Microsoft Word 2013 or later versions.

Launch Word

Opens a new Word instance or opens a Word document.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Launch Word	N/A	With a blank document, and open the following document	With a blank document	Specify whether to open a new Word document, or an existing one
Document path	No	File		The full path of the existing Word document to open
Make instance visible	N/A	Boolean value	True	Specify whether to make the Word window visible or hide it
Open as ReadOnly	N/A	Boolean value	False	Specify whether to open the stored document in read-only mode or not
Read protection password	Yes	Direct encrypted input or Text value		The read protection password on the Word document, if it's password protected
Write protection password	Yes	Direct encrypted input or Text value		The write protection password on the Word document, if it's password protected

Variables produced

Argument	Type	Description
WordInstance	Word instance	The specific Word instance for use with later Word actions. This allows the user to specify which of possibly several Word documents to access

Exceptions

Exception	Description
Failed to launch Word	Indicates a problem launching a Word instance
The Word document was not found	Indicates that the specific Word document could not be found in the provided location
Failed to open existing Word document	Indicates a problem opening the specified Word document
Failed to launch Word application	Indicates that Word application could not be launched due to an internal error
Word application is not installed	Indicates that Word application isn't installed on the specific machine

Attach to running Word

Attaches to a Word document that's already open.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Document name	No	File		The name or the path of the Word document to attach to

Variables produced

Argument	Type	Description
WordInstance	Word instance	The Word instance this action has attached to for use with later Word actions

Exceptions

Exception	Description
Failed to attach to Word document	Indicates a problem attaching to the specified Word document
Specified Word document not found	Indicates that the specific Word document couldn't be found in the provided location
Failed to launch Word	Indicates that Word application couldn't be launched due to an internal error

Save Word

Saves a previously launched Word instance.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Word instance	No	Word instance		The Word instance to save. This variable must have been previously specified in a Launch Word or Attach to running Word action.
Save mode	N/A	Save document, Save document as	Save document	How to save the document of this instance.
Document format	N/A	All available formats from Word app	Default (From Extension)	The format of the document.
Document path	No	File		The full path of the document. Insert the desired document file extension according to the selection in the Document format parameter.

Variables produced

This action doesn't produce any variables.

Exceptions

Exception	Description
Failed to save Word	Indicates a problem saving the Word document
The Word instance or the Word document is not initialized	Indicates that Word instance or Word document specified in action isn't initialized
The operation cannot be performed on a read-only document	Indicates that Word document can't be saved because it is opened as read-only

Close Word

Closes a Word instance.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Word instance	No	Word instance		The Word instance to close. This variable must have been previously specified in a Launch Word or Attach to running Word action.
Before closing Word	N/A	Do not save document, Save document, Save document as	Don't save document	Specify whether and how to save the document of this instance before closing that instance.
Document format	N/A	All available formats from Word app	Default (From Extension)	The format of the document.
Document path	No	File		The full path of the document. Insert the desired document file extension according to the selection in the Document format parameter.

Variables produced

This action doesn't produce any variables.

Exceptions

Exception	Description
Failed to close Word	Indicates a problem closing the Word document
Failed to save Word	Indicates a problem saving the Word document
The operation cannot be performed on a read-only document	Indicates that Word document can't be saved because it is opened as read-only

Read from Word document

Reads the text content from a document of a Word instance.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Word instance	No	Word instance	The Word instance to work with	This variable must have been previously specified in a Launch Word or Attach to running Word action
Retrieve	N/A	Whole document/Pages/Bookmark	Whole document	Whether to retrieve the content of the whole document, of specific pages, or a bookmark
Page	No	Numeric value	1	The pages of the Word document to be read. A range of pages or a list can be provided as 2-5, which will retrieve content from page 2 to page 5 or 2,3,7, retrieve content from 2,3,7 pages
Bookmark	No	Text value		The bookmark of the Word document to be read

Variables produced

Argument	Type	Description
WordData	Text value	The value of the retrieved content

Exceptions

Exception	Description
Failed to read the content from a Word document	Indicates a problem retrieving the content from the specified Word document
The Word instance or the Word document is not initialized	Indicates that Word instance or Word document specified in action isn't initialized

Write to Word document

Write or append text to a Word file.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Word instance	No	Word instance	The Word instance to work with	This variable must have been previously specified in a Launch Word or Attach to running Word action
Text to write	Yes	General value	The text to write in the specified Word document
Append new line	N/A	Boolean value	True	Specifies whether to append a new line at the start of the overall text to write to the document
Write text to	N/A	Beginning of Word file/End of Word file/Before of Bookmark/After of Bookmark	Beginning of Word file	Specifies the position of the Word document where the text will be appended
Bookmark	No	Text value	The target bookmark in the Word document where the text will be appended	This action appends text before or after of the specified bookmark in the Word document

Variables produced

This action doesn't produce any variables.

Exceptions

Exception	Description
The Word instance or the Word document is not initialized	Indicates that Word instance or Word document specified in action isn't initialized
The operation cannot be performed on a read-only document	Indicates that Word document can't be edited because it is opened as read-only
The write operation on the Word document instance failed	Indicates a problem writing content in the specified Word document

Insert image in Word document

Insert an image to a Word file.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Word instance	No	Word instance	The Word instance to work with	This variable must have been previously specified in a Launch Word or Attach to running Word action
Insert image to	N/A	Beginning of Word file/End of Word file/Before of Bookmark/After of Bookmark/Before specific text /After specific text	Beginning of Word file	Specifies the position of the Word document that image will be appended
Insert image from	N/A	File/Clipboard	File	The location of the image to be inserted in the specified Word document
Image path	No	File		The full path of the image to be inserted
Text to find	No	Text value	The text to find in the Word document for inserting image	Image will be appended before or after any occurrence of the specified text
Bookmark	No	Text value	The target bookmark in the Word document where the image will be appended

Variables produced

This action doesn't produce any variables.

Exceptions

Exception	Description
The Word instance or the Word document is not initialized	Indicates that Word instance or Word document specified in action isn't initialized
The operation cannot be performed on a read-only document	Indicates that Word document can't be edited because it is opened as read-only
Failed to insert image	Indicates a problem inserting the image in the specified Word document

Find and replace words in Word document

Finds text and replaces it with another in the active worksheet of an Excel instance.

Input parameters

Argument	Optional	Accepts	Default Value	Description
Word instance	No	Word instance	The Word instance to work with	This variable must have been previously specified in a Launch Word or Attach to running Word action
All matches	N/A	Boolean value	False	Whether to find/ and replace text in all the matching occurrences found or in the first matching occurrence only
Text to find	No	Text value	The text to find in the worksheet
Text to replace with	No	Text value		The text used to replace the matching cells
Use wildcards	N/A	Boolean value	False	Whether to use wildcards for the text to find
Match case	N/A	Boolean value	False	Whether to search for case-sensitive data
Match whole words only	N/A	Boolean value	False	Whether to search for words that are the same as the specified text

Variables produced

This action doesn't produce any variables.

Exceptions

Exception	Description
Failed to replace text in Word document	Indicates a problem replacing the specified text with the provided input
The Word instance or the Word document is not initialized	Indicates that Word instance or Word document specified in action isn't initialized
The operation cannot be performed on a read-only document	Indicates that Word document can't be edited because it is opened as read-only

Known limitations

Using Word files synchronized through OneDrive or SharePoint

Interaction with Microsoft Word files that are contained in folders synchronized in OneDrive or SharePoint might result in an erroneous flow. Power Automate for desktop utilizes COM objects for Word interactions. OneDrive and SharePoint aren't fully compatible with Word instances launched through COM.

For this reason, when you try to open a Word file stored in a OneDrive or SharePoint directory, you might encounter a file not found error. To resolve this issue, use one of the following workarounds:

Workaround 1

• Make a local copy of the respective Word file.
• Modify the local copy of the Word file using Power Automate for desktop Word automation actions.
• Override the Word file copy synchronized through OneDrive or Sharepoint with the local copy that includes the latest changes.

Workaround 2

• Open a new Word instance using the Run application action. Make sure that you provide enough wait time between actions, allowing the Word process to load completely, including any add-ins.
• Use the action Attach to running Word to attach to the new process.

Note

This workaround can be used in general when the Launch Word action fails to execute.