Paging Grid Image Column Component

This page contains information related to an old version of the Read-Only Grid Column Component.

Old versions do not appear in category lists; only the newest versions are listed.

To take advantage of the latest features and improvements, we always recommend you use the latest versions of Interface Components whenever possible. See the latest version's page for information about what's been changed.

The Paging Grid Text Column Component has been deprecated.

Image Column

Function: a!gridImageColumn()

Displays a column of images within a paging grid. To display images in an editable grid, use an image component.


Name Keyword Type Description
Label label Text Name to display for the column heading.
Field field Text Name of the field that populates the column. Stored into Paging and Selection Value when the user clicks on the column label. A sort indicator displays on the column when its Field argument matches pagingInfo.sort[1].field.
Data data Array of Images Array of images values to display in the column. Create images with
Visibility showWhen Boolean Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true.
Size size Text Determines how the images are sized. Valid values: "ICON" (default), "TINY", "GALLERY", "SMALL", "MEDIUM", and "LARGE".
Is Thumbnail isThumbnail Boolean Determines whether the images can be viewed at a larger size when clicked. Multiple images will be visible in a slideshow. Default: false.
Style style Text Determines how the images are rendered. Valid values: "STANDARD" (default) or "AVATAR".

The maximum display dimensions for each Size are listed below:

  • "ICON": 20x20 pixels
  • "TINY": 60x120 pixels
  • "GALLERY": 240x80 pixels
  • "SMALL": 100x200 pixels
  • "MEDIUM": 200x400 pixels
  • "LARGE": 400x600 pixels


  • If Style is set to "STANDARD", images are scaled down as necessary to fit the size limit, preserving their natural aspect ratio. Images will never be scaled up with this configuration, so they'll display at their natural size if they are smaller than the configured size.
  • If Style is set to "AVATAR", images are scaled down or up as necessary to fit the size limit, preserving their natural aspect ratio, and cropped in a circle.
  • Images look best with the ICON size if they are 40 x 40 pixels and have a transparent background. The images display at 20 x 20 pixels but an original size of 40 x 40 pixels is recommend if any users view the images on high-definition screens, like an iPhone, iPad, or Mac.
  • The Field parameter determines whether a sort indicator displays for that column. If the data is sorted by that value, but the Field parameter is null, the sort indicator will not display.
  • Avoid using this component for offline mobile forms because images do not render when offline.

See Also: Indicator Icons

Open in Github

On This Page