Skip to main content
Version: Current

Replace Picture

Description

The Replace Picture activity replaces one or more pictures within a Microsoft Word document by matching their alt text.

The activity updates the specified Word File in place. The same file reference can be used by subsequent Word activities.


Common Capabilities

Process Data Support

info

This activity supports dynamic configuration using variables from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.

Learn more → Using Process Data


Execution Control

info

Controls how this activity behaves when multiple incoming execution paths converge.

Learn more → Execution Control


On Error

info

Defines how the workflow behaves if this activity encounters a runtime error.

Learn more → On Error


Design-Time Configuration

Display Text

The label displayed for this activity on the workflow canvas.

Word File

The Word document to modify.

See Word Document Selection.

Password

Optional password used to open a password-protected document.

Alt Text

The alt text used to identify pictures to replace.

All pictures whose alt text matches the specified value are replaced.


Picture

Select Picture By

Specifies how the replacement picture is provided.

Available options:

  • File
  • URL
  • Base64

Default: File

Picture File

A file reference to the replacement image.

Required when Select Picture By is File.

Picture URL

The public HTTP or HTTPS URL of the replacement image.

Required when Select Picture By is URL.

Picture Base64

The image content encoded as Base64.

Both raw Base64 content and data URI formats are supported.

Required when Select Picture By is Base64.

Supported Image Formats

Common image formats such as PNG, JPG, JPEG, GIF, and BMP are supported.

Format support can vary depending on the operating system and Word rendering engine.


Picture Options

Width (Centimeters)

Optional width to apply to the replacement picture.

Height (Centimeters)

Optional height to apply to the replacement picture.


Cross-Platform Considerations

warning

Image rendering and format support can vary between Windows and Linux depending on the underlying image processing libraries.

For the most consistent results across platforms, use PNG or JPG images.


Outputs

Document Ranges

A collection of document ranges where pictures were replaced.

See DocRange.