An unexpected error occurred.

.learn-article-nav-parent span { font-weight: 700; } .learn-article-page-container { padding: 0 1.5rem 1.5rem 1.5rem; } .liferay-nav-item-border { border-bottom: 1px solid #E2E2E4; } .liferay-nav-item-right-arrow { background-color: currentColor; display: inline-block; height: 16px; mask-image: url("data:image/svg+xml,%3Csvg width='16' height='16' viewBox='0 0 16 16' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M10.5593 7.32801L6.44914 3.27799C5.60571 2.48472 4.46015 3.56307 5.2847 4.34085L9.00776 8.00043L5.26267 11.7003C4.49477 12.4223 5.67809 13.4821 6.44914 12.757L10.5687 8.69764C11.1006 8.20804 11.1887 7.91057 10.5593 7.32801Z'/%3E%3C/svg%3E"); mask-repeat: no-repeat; mask-size: contain; transition: transform 0.3s ease-in-out; width: 16px; } .menu-nav-items-capabilities.show, .menu-nav-items-documentation.show { display: flex !important; flex-direction: column; } .menu-trigger { cursor: pointer; } .menu-trigger.show .liferay-nav-item-right-arrow { transform: rotate(90deg); } .table-of-contents-documentation { display: none; } .table-of-contents-documentation, .menu-trigger-capabilities { align-items: center; justify-content: space-between; } .table-of-contents-documentation span { font-weight: 700; } .learn-article-nav-parent { border-bottom: 1px solid #E2E2E4; padding: 8px; } .primary-item-toc { align-items: center; border-radius: 8px; display: flex; gap: 12px; padding: 8px 12px !important; width: 100% !important; } .primary-item-toc svg { margin-top: 0; } .primary-item-toc:hover { background-color: var(--color-action-neutral-hover-10, #eaecee); color: var(--color-action-primary-hover, #0053f0) !important; transition: box-shadow 0.1s linear, background-color 0.1s linear; } .primary-item-toc .liferay-nav-item-right-arrow { display: none; } .learn-article-nav-item .liferay-nav-item { align-items: center; display: flex; justify-content: space-between; width: 100%; } .liferay-nav-item { margin-top: 5px; } @media (max-width: 1024px) { .learn-article { padding: 0 !important; } .learn-article-content-container, .learn-article-page-container { flex-direction: column !important; } .learn-article-nav-container { max-width: 100% !important; } .learn-article-nav-content { margin-bottom: 40px; } .learn-article-nav-parent .primary-item-toc svg{ display: none; } .learn-article-page-container { padding: 0; } .menu-nav-items-capabilities, .menu-nav-items-documentation { display: none; } .menu-trigger-capabilities { justify-content: space-between !important; padding: 8px; } .menu-trigger-capabilities .liferay-nav-item-right-arrow { display: flex !important; } .table-of-contents-documentation { display: flex; padding: 16px 18px; } .primary-item-toc .liferay-nav-item-right-arrow { display: flex; } .primary-item-toc { justify-content: space-between; } .primary-item-toc:hover { background: none; color: var(--color-neutral-10, #282934) !important; } } @media (min-width: 1025px) { .learn-article-nav-parent .primary-item-toc { display: flex; } .menu-nav-items-capabilities, .menu-nav-items-documentation { display: flex !important; flex-direction: column; } .menu-trigger-capabilities .liferay-nav-item-right-arrow, .menu-trigger-documentation .liferay-nav-item-right-arrow { display: none !important; } }

Configuring Documents and Media Previews

Liferay 7.4 U84+/GA84+

By default, Liferay uses PDFBox to generate previews for files added to the document library. This is because PDFBox is the only 100% Java-based tool that can be distributed with DXP.

However, since PDFBox only supports a limited number of file types, Liferay also provides integration with third-party services to support additional file types. These services can be used to generate high quality file previews more quickly for more of your files.

Important

To use third-party services to generate previews, you must first install them on the server running your Liferay instance.

Liferay currently supports integration with these services:

LibreOffice or OpenOffice: These programs can be used in server mode to generate thumbnails and previews for supported file types (.docx, .odt, .ppt, .odp, etc.). You can also use them to convert documents and view them in your browser. See Enabling OpenOffice/LibreOffice Integration to learn more.
ImageMagick (also requires Ghostscript): These programs provide fast, high-quality previews and conversions for image files. See Enabling ImageMagick and Ghostscript for more information.
FFmpeg: This program provides support for audio and video files. In addition to generating file previews, you can play multimedia in your browser’s native HTML 5 player. See Enabling FFmpeg for Audio and Video Previews for more information.

Note

Liferay 7.3.x and earlier versions use Xuggler for generating audio and video previews. See Enabling Xuggler for more information.

With these services installed and configured, Documents and Media can provide in-application previews of most file types.

Configuring Supported Media Types for ImageMagick

If you’ve installed ImageMagick, Adaptive Media can use it to generate alternative resolutions for images stored in the document library. By default, ImageMagick supports avif, gif, heic, tiff, and webp files, but you can add additional media types if needed. See Adaptive Media Configuration Reference for more information.

Manually Generating Previews and Thumbnails

Once you’ve enabled third-party services, Liferay automatically uses them to generate previews and thumbnails for supported media types. However, if you’ve uploaded assets before enabling these services, you must generate the thumbnails and previews manually.

To generate them for image files, you can use Adaptive Media. See Managing Image Resolutions for more information.

For audio, video, PDF, and OpenOffice files, you can regenerate previews and thumbnails via the Server Administration application:

Open the Global Menu ( ), go to the Control Panel tab, and click Server Administration.
Go to the Resources tab.
Under Regeneration Options, click Execute for the desired media type.

This begins generating missing images for the documents. Running this process does not affect existing previews and thumbnails. If you want to regenerate all previews and thumbnails, first execute this clean-up action: Reset preview and thumbnail files for documents and media.

Execute Reset preview and thumbnail files for documents and media.