Publishing Pages publishing-pages

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

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 also publish/unpublish a page immediately or at a predefined date/time in the future.

NOTE
Certain terms related to publishing can be confused:
  • Publish / Unpublish
    These are the primary terms for the actions that make your content publicly available on your publish environment (or not).

  • Activate / Deactivate
    These terms are synonymous with publish/unpublish.

  • Replicate / Replication
    These are the technical terms describing the movement of data (e.g. page content, files, code, user comments) from one environment to another such as when publishing or reverse-replicating user comments.

NOTE
If you do not have the required privileges for publishing a specific page:
  • A workflow will be triggered to notify the appropriate person of your request to publish.
  • This workflow may have been customized by your development team.
  • A message will be displayed briefly to notify you that the workflow was triggered.

Publishing Pages publishing-pages-2

Depending on your location, you can publish:

Publishing from the Editor publishing-from-the-editor

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

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

    screen_shot_2018-03-21at152734

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

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

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

      • Specify which of the assets/tags/etc. you want to publish together with the page, then use Publish to complete the process.
      • Use Cancel to abort the action.

    chlimage_1-50

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

    screen_shot_2018-03-21at152840

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

    screen_shot_2018-03-21at152951

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

Publishing from the Console publishing-from-the-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 on the Quick Publish button.

    screen_shot_2018-03-21at153115

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

    chlimage_1-51

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

NOTE
Quick Publish is a shallow publish, i.e. 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 as well as offering the option to publish at a later date.

To publish or unpublish a page using Manage Publication:

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

    screen_shot_2018-03-21at153309

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

    • Choose to publish or unpublish the selected pages.
    • 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.

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

    chlimage_1-52

    Click Next to continue.

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

    screen_shot_2018-03-21at153354

    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.

    Clicking 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.

    Back in the wizard, you can select an item in the list to configure its further options such as:

    • Include its children.
    • Remove it from the selection.
    • Manage its published references.

    screen_shot_2018-03-21at153450

    Clicking Include Children opens a dialogue allowing you to:

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

    Click Add 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.

    chlimage_1-53

    Returning to the wizard you see the pages added based on your choice of options in the Include Children dialogue.

    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.

    screen_shot_2018-03-21at153801

    The Published References dialogue displayes the references for the selected content. By default they are all selected and will be published/unpublished, but you can uncheck to deslect them so that they are not included in the action.

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

    screen_shot_2018-03-21at153824

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

    screen_shot_2018-03-21at153925

  4. Click Publish to complete.

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

    screen_shot_2018-03-21at153951

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

    note note
    NOTE
    The Workflows step will be shown based on what rights your user may or may not have. See the previous note on this page regarding publishing privileges as well as 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-resourse support.
    • Define a title of the workflow package if the option to keep the workflow package was chosen.

    Click Publish or **Publish Later **to complete the publication.

    chlimage_1-54

Unpublishing Pages unpublishing-pages

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

In a manner similar to publishing, one or more pages can be unpublished:

Unpublishing from the Editor unpublishing-from-the-editor

When editing a page, if you wish 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 can not 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 on 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.

    chlimage_1-55

    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.

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

  3. To complete the unpublication, continue through the wizard as you would to publish the page.

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 wish 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.

    chlimage_1-56

  4. In the Include Children dialogue, uncheck the options:

    • Include only immediate children
    • Include only already published pages

    These options are selected by default, so you must remember to unselect them. Click Add to confirm and add the content to the publication/unpublication.

    chlimage_1-57

  5. The Manage Publication wizard lists the content of the tree for review. You can further customize the selection by adding additional pages or removing those selected.

    screen_shot_2018-03-21at154237

    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 unpublication of the tree.

Determining Publication Status determining-publication-status

You can detemine the publication status of a page:

recommendation-more-help
5f6f1f67-8db1-40cb-84e9-024e65b9fc4c