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.