ÃÛ¶¹ÊÓƵ

Publishing Pages publishing-pages

Once you have created and reviewed your content on the author environment, the goal is to make it available on your public website (your publish environment).

This is referred to as publishing a page. When you want to remove a page from the publish environment is referred to as unpublishing. When publishing and unpublishing the page remains available on the author environment for further changes until you delete it.

You can publish/unpublish a page immediately or at a predefined date/time in the future.

NOTE
Publishing an Experience Fragment basically follows the same procedure as for publishing a page, though from the Experience Fragments console or editor.

Terminology terminology

You may encounter different terms related to publishing as you work with ÃÛ¶¹ÊÓƵ Experience Manager (AEM) as a Cloud Service.

  • Publish / Unpublish

    • These are the primary terms for the actions that make your content publicly available on your publish environment (or not).
    • These are the terms used in AEM documentation.
  • Activate / Deactivate

    • These terms are synonymous with publish/unpublish.
    • These terms were used in previous versions of AEM.
  • Replicate / Replication

    • These are the technical terms describing the movement of data (for example, page content, files, code, user comments) from one environment to another when you publish a page.
    • These terms are primarily used by developers.

Publishing Pages publishing-pages-1

Depending on your location, you can publish:

NOTE
If you do not have the required privileges for publishing a specific page:
  • A workflow is triggered to notify the appropriate person of your request to publish.
  • This workflow may have been customized by your development team.
  • A message is displayed briefly to notify you that the workflow was triggered.
NOTE
If you want to preserve page order you have to use Manage Publication to publish the parent page together with any child pages - in a single action.
Page order is not guaranteed:
  • if only child pages are selected for publication (as the order information is held on the parent page)
  • if the parent and child pages are published in separate actions
NOTE
For additional possibilities see On Time and Off Time in the Basic tab of Page Properties

Publishing from the Page Editor publishing-from-the-page-editor

If you are editing a page in the page editor, it can be published directly from the editor.

  1. Select the Page Information icon to open the menu and then the Publish Page option.

    Publishing a page via page options

  2. Depending on whether the page has references that need publishing:

    • The page is published directly if there are no references to be published.

    • If the page has references that need publishing, these are listed in the Publish wizard, where you can either:

      • Specify which of the assets, or tags, and so on, that you want to publish together with the page, then use Publish to complete the process.
      • Use Cancel to abort the action.

    Publishing references with the page

  3. Selecting Publish will replicate the page to the publish environment. In the page editor, an information banner is shown confirming the publish action.

    Publish status info banner

    When viewing the same page in the console, the updated publication status is visible.

    Page publication status in column view in the sites console

NOTE
Publishing from the page editor is a shallow publish, that is, only the selected page/pages is/are published and any child page(s) is/are not.
NOTE
Pages accessed by aliases in the editor cannot be published. Publish options in the editor are only available for pages accessed via their actual paths.

Publishing from the Site Console publishing-from-the-sites-console

In the Sites console there are two options for publishing:

Quick Publish quick-publish

Quick Publish is for simple cases and publishes the selected page(s) immediately without any further interaction. Because of this, any non-published references will also be published automatically.

To publish a page with Quick Publish:

  1. Select the page or pages in the sites console and click the Quick Publish button.

    Selecting pages for publication

  2. In the Quick Publish dialog, confirm the publication by clicking on Publish or cancel by clicking on Cancel. Remember that any unpublished references will automatically be published as well.

    Quick publish confirmation

  3. When the page is published an alert is shown confirming the publication.

NOTE
Quick Publish is a shallow publish, that is, only the selected page/pages is/are published and any child pages are not.

Manage Publication manage-publication

Manage Publication offers more options than Quick Publish, allowing for the inclusion of child pages, customization of the references, and starting any applicable workflows and offering the option to publish at a later date.

NOTE
If you want to preserve page order you have to use Manage Publication to publish the parent page together with any child pages in a single action.
Page order is not guaranteed:
  • if only child pages are selected for publication (as the order information is held on the parent page)
  • if the parent and child pages are published in separate actions

To publish or unpublish a page using Manage Publication:

  1. Select the page or pages in the sites console and click the Manage Publication button.

    Selecting pages for publication

  2. The Manage Publication wizard starts. The first step, Options, lets you:

    • Action

      Choose to publish or unpublish the selected pages.

    • Scheduling

      Choose to take that action now or at a later date.

      Publishing later starts a workflow to publish the selected page or pages at the specified time. Conversely, unpublishing later starts a workflow to unpublish the selected page or pages at a specific time.

      note note
      NOTE
      If you want to cancel a publish/unpublish later, go to the Workflow Console to terminate the corresponding workflow.

    Manage Publication Options

  3. Click Next to continue.

  4. In the next step of the Manage Publication wizard, Scope, you can define the scope of the publication/un-publication such as including to include child pages and/or including references.

    Manage Publication Scope

    Add Content

    You can use the Add Content button to add additional pages to the list of pages to be published in case you neglected to select one before starting the Manage Publication wizard.

    Selecting the Add Content button starts the path browser to allow content selection.

    Select the required pages and then click Select to add the content to the wizard or Cancel to cancel the selection and return to the wizard.

    Remove Selection

    Back in the wizard, you can select an item in the list to remove it from the selection.

    Manage Publication selecting pages

    Published References

    You can view and modify the references to be published or unpublished for a page by selecting it and then clicking the Published References button.

    Manage Publication Options

    The Published References dialog displays the references for the selected content. By default, they are all selected and are published/unpublished, but you can un-check to deselect them so that they are not included in the action.

    Click Done to save your changes or Cancel to cancel the selection and return to the wizard.

    Back in the wizard, the References column is updated to reflect your selection of references to be published or unpublished.

    Manage Publication selecting pages

    Include Children

    note note
    NOTE
    See Publishing and Unpublishing a Tree

    Clicking Include Children opens a dialog box allowing you to:

    • Include children
    • Include only immediate children
    • Include only modified pages
    • Include only already published pages

    Activate the required options and confirm with OK to add the children pages to the list of pages to be published or unpublished based on the selection options. Click Cancel to cancel the selection and return to the wizard.

    Manage Publication including children

  5. Click Publish to complete.

    Back in the sites console a notification message will confirm the publication.

  6. If the published pages are associated with workflows, they may be shown in a final Workflows step of the publication wizard.

    Manage Publication selecting pages

    note note
    NOTE
    The Workflows step is shown based on what rights your user may or may not have. See the previous note on this page regarding publishing privileges and Managing Access to Workflows and Applying Workflows to Pages for details.

    The resources are grouped by the workflows triggered and each given options to:

    • Define the title of the workflow.
    • Keep the workflow package, provided that the workflow has multi-resource support.
    • Define a title of the workflow package if the option to keep the workflow package was chosen.
  7. Click Publish or Publish Later to complete the publication.

Unpublishing Pages unpublishing-pages

Unpublishing a page will remove it from your publish, or preview, environment so that it is no longer available to your readers.

In a manner similar to publishing, one or more pages can be unpublished from the desired destination:

Unpublishing from the Editor unpublishing-from-the-editor

When editing a page, if you want to unpublish that page, select Unpublish Page in the Page Information menu, much as you would publish the page.

NOTE
Pages accessed by aliases in the editor cannot be unpublished. Publish options in the editor are only available for pages accessed via their actual paths.

Unpublishing from the Console unpublishing-from-the-console

Just as you use the Manage Publication option to publish, you can also use it to unpublish.

  1. Select the page or pages in the sites console and click the Manage Publication button.

  2. The Manage Publication wizard starts. In the first step, Options, select to Unpublish instead of the default option of Publish.

    Unpublishing - Options

    Just as publishing later starts a workflow to publish this version of the page at the specified time, deactivating later starts a workflow to unpublish the selected page or pages at a specific time.

    note note
    NOTE
    If you want to cancel a publish/unpublish later, go to the Workflow Console to terminate the corresponding workflow.
    note note
    NOTE
    If you have a Preview environment you can select the Destination during Manage Publication.
  3. To complete the un-publication, continue through the wizard as you would to publish the page.

    Unpublishing - Scope

Publishing and Unpublishing a Tree publishing-and-unpublishing-a-tree

When you have entered or updated a considerable number of content pages - all of which are resident under the same root page - it can be easier to publish the entire tree in one action.

You can use the Manage Publication option on the sites console to do this.

  1. In the sites console, select the root page of the tree you want to publish or unpublish and select Manage Publication.

  2. The Manage Publication wizard starts. Choose to publish or unpublish and when it should occur and select Next to continue.

  3. In the Scope step, select the root page and select Include Children.

    Manage Publication selecting pages

  4. In the Include Children dialog:

    • select Include Children
    • unselect Include only immediate children
    • unselect Include only already published pages
    • configure Include only modified pages as required

    These options are selected by default, so you must remember to configure them. Confirm the selection with OK to add the content to the publication/un-publication.

    Including children for tree publication

  5. In the Manage Publication wizard you can further customize the selection by adding additional pages or removing those selected.

    Remember that you can also review the references to be published via the Published References option.

  6. Continue the Manage Publication wizard as normal to complete the publication or un-publication of the tree.

Determining Publication Status determining-publication-status

You can determine the publication status of a page:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab