The insert media action enables you to insert an image or other media file into an open Pages document at a chosen page and size. You can use it to automatically add logos, screenshots, charts, product images, or any other media to a document without manual editing.

Prerequisite

Before using this action, ensure that you first use the Set Document Properties action in your automation. The Set document properties action defines the page size and orientation of a Pages document, which establishes the layout framework for placing content. For more information, see Set document properties action.

When you use the Insert media action, the X and Y position values are calculated based on the page layout configured earlier. If the layout is not set correctly, the media might not appear in the intended position.

For example, if you set the page orientation to landscape and then specify X and Y coordinates in the Insert media action, the media is placed according to the landscape layout, ensuring accurate positioning within the document.

Settings

  • Use the Session name field to select one of the following options:
    • Session name: Enter the name of the session used during the Open action.

      (Optional) Click the Insert a value icon to select an existing variable that you have used to store the default session name.

    • Variable: Enter the name of the variable that you have used to store the session name.
  • Select one of the following options to specify a media path:
    • Variable: Enables you to open a file by specifying a file variable.
    • Control Room file: Enables you to open a file from the Control Room.
    • Desktop file: Enables you to open a file from the device. This field also accepts the file path input as a string variable or global value
  • Select one of the following options to specify the location in the document where the media must be inserted:
    • Current page: Inserts media on the page that is currently active in the session.
    • Specific page(s): Inserts media on a specific page. Enter the page number where you want to insert media.
  • X-Position: Specify the horizontal position in cm.
  • Y-Position: Specifies the vertical position in cm.
  • Select the Resize media check box to adjust the size of the media. Specify the Width and Height of the media in centimeters.
  • Select the Maintain aspect ratio check box to ensure that the media keeps its original proportions while resizing.