Version: eXtendFiles 1.6.2 and above
Audience: Administrator, User

Overview

For supported file formats, eXtendFiles generates preview and thumbnail images uploaded files.

You can enable or disable this feature from the eXtendFiles Setup page. For instructions on how to do so, NetSuite Administrators can refer to Turn Off Generation of Image Thumbnail and Image Previews.

Preview Generation

  • Preview images are generated only when the file cannot be natively viewed within the web browser. For example, files such as .png, .jpg, .jpeg, and .pdf are natively viewable in web browsers, so preview images will not be generated for them. Instead, the original file's link will be used as the preview image.

  • If the file size of the preview image exceeds the maximum file size specified in eXtendFiles' INLINE VIEW MAX PREVIEW SIZE(MB) setting, the generated thumbnail image will be used as the preview image.

  • Details about the dimensions of the generated preview or thumbnail image are saved in the field eXtendFiles - Thumbnail/Preview File Id and Folder Id, along with the folder ID in JSON format.

    Example: 
    {"preview":{"folderId":"fa311609-ff94-4508-b86d-ad06eb7bb2e3","fileInfo":{"dimension":"3508x2480"}},"thumbnail":{"folderId":"77d35263-abb3-47a6-b34e-07aa146cd32e","fileInfo":{"dimension":"150x106"}}

  • If the eXtendFiles record is private, the preview image will also be private.
  • Supported File Types Supported For Conversion lists the file types that are supported for file conversion or preview/thumbnail generation.

Thumbnail Generation

  • Thumbnail dimensions have a fixed maximum height and width of 150px. However, the height, width, or both may be lower than 150px in order to maintain the aspect ratio of the image.

  • As mentioned in the previous section, details about the dimensions of the generated preview or thumbnail image are saved in the field eXtendFiles - Thumbnail/Preview File Id and Folder Id, along with the folder ID in JSON format.

    Example: {"preview":{"folderId":"fa311609-ff94-4508-b86d-ad06eb7bb2e3","fileInfo":{"dimension":"3508x2480"}},"thumbnail":{"folderId":"77d35263-abb3-47a6-b34e-07aa146cd32e","fileInfo":{"dimension":"150x106"}}
  • The generated thumbnail URL will always be public even if the eXtendFiles is set to be private, unless the Make Thumbnail Private preference is enabled on the eXtendFiles Setup page. NetSuite Administrators can see Configure eXtendFiles File Sharing Settings for more details on enabling and disabling the preference.

Note: For more details regarding viewing private preview images and thumbnail images, please see the following articles:
  1. Generating eXtendFiles signed URL using workflow
  2. Accessible URLs present on eXtendFiles record

Preview & Thumbnail Timing

When an eXtendFile record is added or updated, the file is immediately added to the configured backend storage. As soon as the upload completes, the file has been updated within your backend storage account and the new file is available for download.

Preview and thumbnail generation is a variable process depending on eXtendFiles' global file conversion server load. As a result, they don't always appear immediately. Sometimes they may appear within a few minutes, but during periods of high eXtendFiles file conversion volume, it could take longer. For organizations which require quicker preview and thumbnail generation, eXtendTech offers dedicated image conversion services as an eXtendFiles addon.