CMS: Publish a Page, File or Folder


Overview


Find out how to publish pages, files and folders within the campus CMS.

Critical Concepts


Publishing rules

  1. You can publish a single page, a folder, or the entire site though we recommend publishing the smallest number of files at a time because there is only one publish queue per site. Do not publish the entire Blink or TritonLink site. It will take hours, and those sites are published every weekend already.
  2. You don't need to publish blocks or homepage_internal assets. Instead, you publish the page they appear on.
  3. When you publish a folder, all pages within that folder will also be published unless you set them to not publish.
  4. When you create a new page or folder in your site, you have to publish the parent folder in order for your new content to appear in the left-hand navigation. If your new page or folder is at the first (top) or second level, you will need to republish the entire site for the new content to show up in the top navigation that is displayed on every page.

Steps to Take


How to Publish

  1. Navigate to the page or folder you want to publish
  2. Click Publish in the upper right
  3. When you publish, you will see 1 or 2 destinations, depending on your access:
    1. Staging is the preview or staging site. Always leave this checked.
    2. Delivery is the live site. Uncheck "delivery" if you are still reviewing a page or want to share a preview link with a manager or colleague. Leave "delivery" checked if you want to publish to the live site.
  4. Click Submit.
    Screenshot: Publish file check options for delivery and/or staging

Publish Queue

  1. When you submit a publishing job, a pop-up will show: "Page queued for publish. View publish queue." You can click on View publish queue to see the progress of the publishing job.
  2. To check the publishing queue from any page, click on the hamburger menu (three horizontal lines) in the upper right corner and click Publish Queue.

Review the page on the site

If you published to delivery, bring up the page in your browser and hit the refresh button.

If you published an existing page to stage only: Bring up the live page add "stage-" to the beginning of the URL.

If you published a new page to stage only:

  1. The staging site URL will start with http://stage-sitename.ucsd.edu. For example: http://stage-blink.ucsd.edu
  2. Copy the breadcrumb of the page from the CMS (not including the site name) and append that onto the end of the URL
  3. Add ".html" to end:
    • Ex: /_draft/allisa-becker/article
    • URL: http://stage-blink.ucsd.edu/_draft/allisa-becker/article.html

Error: Asset Not Set to Publish

  1. When you try to publish, if you see this error:  "Asset is not set to publish. Please enable publishing for this asset and try again."
    it means that this file (or a folder that contains this file) has publishing disabled. You will need to check if the page and/or any folders containing it are enabled for publishing.
  2. A common scenario is trying to publish a news item for your home page. In that case, publish the actual page (/index) not the news block.

Setting a file to not publish

Disable a page from being published to the live site. You may want to do this if a page is still being developed and you are concerned that:

Contact wts@ucsd.edu if you have trouble publishing an asset.