Skip to content Skip to main navigation Skip to footer

Size of Merged Image is Bigger or Smaller Than Expected

Issue Summary

Sometimes when merging images into a document, the images may appear much smaller or larger than expected. This is typically due to how the image merge field is positioned and formatted in the template.

Root Cause

Opero Documents merges images based on how the merge field is placed in your document template:

  • Outside a table: Images merge at their original size.
  • Inside a table cell: Images may scale down depending on the cell’s width and other table properties.

How Image Sizing Works

Image Not in a Table

  • Image merge field is placed in the body of the document (not inside a table).
  • The image merges at its original size.
  • If it appears smaller than expected:
    • Check the source image size and resolution.
    • Check for possible layout constraints like text boxes, margins, or page width.

Image Inside a Table Cell

  • By default, the table resizes to match the image’s actual size after generation.
  • However, if the column is narrow, the image may shrink to fit.
  • Height settings are not respected—only width can control image resizing.

Steps to Resolve

How to Control Image Size in Tables

To ensure images scale the way you want:

  1. Open your document template.
  2. Click into the table cell containing the image merge field.
  3. Click Edit Table or Table Properties.
  4. Set a specific width for the column or cell.
    • Width will control how the image is resized.
    • Height will not resize the image.
  5. Save your changes and generate a test document.

Additional Notes

  • To make the image stretch to fill a table cell, set the cell width larger than the image (or leave it unrestricted), and define a specific row height. In some cases (especially in Google Docs), this causes the image to stretch to fill the entire cell space, even though image height isn’t directly controlled.
  • You cannot manually resize images through the app interface.
  • To avoid inconsistent sizing across repeated items (e.g., quote line items), ensure consistent table column widths.

Related Resource

For more guidance on template formatting and merge fields:
Template Configuration Guide