oo

Exporting/Importing Site Pages and Content

Liferay sites include the export/import applications for extracting and transferring site data as Liferay Archive (LAR) files. You can access these tools at the site level.

note

You can also access export and import functions for individual site applications and page widgets.

Site LAR Properties and Requirements

LARs have these properties and requirements:

  • LARs are version dependent. They can be imported into a site on another Liferay server, as long as the Liferay versions on each server are the same.

  • Some naming conflicts are handled automatically. For example, if the LAR you’re importing and the site both have a page with the same friendly URL, a number is appended to the friendly URL and incremented until the conflict no longer occurs. The same is true for category names.

  • You can use LARs to restore a site, but you must delete your site entirely and then create a new site with the same name to import the LAR into. This avoids potential data conflicts between content that exists both in the LAR and in the site.

important

Periodically exporting LARs is not a backup solution; it should only be used to migrate data between two environments. Please refer to the Backing up a Liferay Portal Installation to learn about backing up your Liferay installation.

Exporting Site Pages and Content

Follow these steps to export site pages and content:

  1. Open the Product Menu (Product Menu), expand Publishing, and click Export.

  2. Click Add (Add Button) to create a new export process.

    This opens an export template.

    Name and configure the export template.

  3. Enter a title for the export process.

  4. Configure the export process by selecting the site pages and content you want to export.

    Under Pages, you can select which pages and page sets are included in the export. You can also determine whether the Theme Settings, Logo, Site Page Settings, and Site Template Settings are included.

    Under Content, you can select which applications are included in the export. You can also determine whether to export all data for the selected applications, or filter included application data by date or time.

    Under Permissions, determine whether to include page and content permissions in the export.

  5. Click Export to begin the export process.

Once finished, click the Download button (Download Button) to download the generated LAR file. You can now import the LAR to another Liferay site.

Download the LAR file.

note

The generated LAR includes all data selected during export configuration. If this includes private or sensitive information, ensure the LAR file is stored in a secure location.

Importing Site Pages and Content

important

If the exported site uses a template, you must first export and import the site template to the Liferay installation before you can import the site. See Exporting and Importing Site Templates for more information.

Follow these steps to import site pages and content:

  1. Open the Product Menu (Product Menu), expand Publishing, and click Import.

  2. Click the Add button (Add Button) to create a new import process.

  3. Add the desired LAR file and click Continue.

    Add the LAR file and click Continue.

  4. Review and configure the import process.

  5. Click Import to begin importing.

    Configure and begin the import process.

Creating Export Templates

Instead of manually creating an export process every time you export site pages content, you can create an export template to store and reuse your export settings. To create an export template, follow these steps:

  1. Open the Product Menu (Product Menu), expand Publishing, and click Export.

  2. Click Options Options Icon in the Application Bar and select Export Templates.

    Click the Actions button in the Application Bar and select Export Templates.

  3. Click Add (Add Button).

  4. Name and configure the export template.

  5. Click Save.

You can now select your template when creating a new export process.

Configuring Export/Import Processes

Liferay provides settings for configuring export/import processes as well as staging specific features. These settings affect staging and site template propagation.

Setting Description
Include All Asset Links If checked, all asset links are included from the site within the given date range. If unchecked, only asset links connected to the content are included.
Replicate Individual Deletions by Default If checked, delete operations performed for content types are always replicated in the target site by default.
Publish Permissions by Default If checked, permissions assigned for exported pages and individual portlet windows are always included by default.
Validate File Entries If checked, publishing or importing content types with text causes Liferay to check the content for links to documents and ensure they point to valid documents.
Validate Journal Feed References If checked, publishing or importing content types with text causes Liferay to check the content for references to web content feeds and ensure they point to valid feeds.
Validate Layout References If checked, publishing or importing content types with text causes Liferay to check the content for links to one of the portal’s virtual hosts and ensure they point to a valid Liferay page. Uncheck this if your virtual host has pages not in Liferay.
Validate Missing References If checked, publishing and import processes cause Liferay to check for missing references. If unchecked, missing reference validation is skipped. As a result, references without existing targets can be published or imported to the target site.
Capability: