Migrating from Zen to Theme Press

Content Layer

name	Page Info
id	278129461
class	watermark-layer

Content Column

name	Page Body
width	100.00001%
id	278129463

Content Block

background-color	transparent
name	Prompt
id	494677873
class	tight manual-prompt-flex

Moving your content from Zen Foundation to Theme Press.

Before migrating your production server, be sure to:

Content Block

name	Outcome
rich-link-hovers	true
id	1042866408
class	tight manual-outcome-flex

Successfully transitioning from Zen Foundation to Theme Press your content requires migration of all of your Zen pages, brands, macros, and other settings. To facilitate this process, we have created the Zen Migrator add-on, available by request via our normal support process.

Action Button

link	brikit:Contact
text	Request the Zen Migrator App
url	https://support.brikit.com/

Info

Version Requirements

Zen Foundation 5.2.16 (or higher) and Theme Press 1.1.7 (or higher) are required to complete the migration successfully.

Note

verify your results in a test environment
backup your site and verify the validity of the backup

Content Block

name	Note
rich-link-hovers	true
id	495965127
class	manual-note-flex
collapsible	collapse

Note

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.

Content Block

name	Tip
rich-link-hovers	true
id	894522670
class	manual-tip-flex
collapsible	collapse

Tip

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

Content Block

name	Warning
rich-link-hovers	true
id	894530759
class	manual-warning-flex
collapsible	collapse

Warning

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

Content Block

name	Info
rich-link-hovers	true
id	894537203
class	manual-info-flex
collapsible	collapse

Info

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

Content Layer

id	504856269

504856279

Where do I find these themes?

You find these themes in the Theme tab of the

(In Theme Press, themes are located in the theme tab of the Theme Press Designer.

tight-bottom

Info

Version Requirements

Zen Foundation 5.2.16 (or higher) and Theme Press 1.1.7 (or higher) are required to complete the migration.

Warning

Caution

Looking to upgrade to Confluence 7.x? Due to compatibility issues, it is important to migrate from Zen to Theme Press BEFORE upgrading Confluence.

Content Column

width	18.0%
id	504955184

Content Block

id	504955185

Content Column

tabbed-blocks

tabs

width

82.0%

id

Content Block

name	Basics
rich-link-hovers	true
id	494842117
class	manual-outcome-flex

The Basics

Before beginning migration, we recommend familiarizing yourself with the concepts below.

Before you migrate, review the following information.

Migration Page

Once you install the add-on, complete the following to access the migration page.

Access the admin console.
Locate the Zen Migrator section on the left.
Click the Migrate Zen Foundation to Theme Press link.

HTML Wrap

class	docs-screenshot

Image Removed

Expand

title

Site vs. Space

As you move through the process, the migrator takes note of:

Zen'

s application on

s application on a site-wide and space-by-space basis

any

Any spaces using themes other than the default

any

Any spaces using layouts other than the master

Expand

title	Zen Pages

When you migrate, your Zen pages become Theme Press architect pages. The migrator creates an architect page for each header, layout (page or blog), menu and footer page in your site. For each admin-notice page, the migrator creates a banner page.

Info

Layouts Overriding Master Layouts

The migrator also creates a Theme Press layout page for any Zen layout overriding the master.

Expand

title	Brands

What were called brands in Zen Foundation are now called themes in Theme Press. Migrating involves creating a Theme Press theme for each Zen brand that is not a built-in brand.

Expand

title	Defaults

Both Zen and Theme Press allow you to set a default theme (brand

/theme

). Likewise, you have defaults for Zen and architect pages. You do not need to map your defaults from Zen to Theme Press. The migrator sets them for you.

Expand

title	Overrides

The migrator also looks for any spaces using a brand or Zen page other than the default, including layouts overriding the master. The migrator applies these overrides accordingly in Theme Press.

Expand

title	Macros

Macros available through Zen differ from those in Theme Press. In some cases, Theme Press offers equivalent macros. When available, you can use the migrator to convert Zen macros into Theme Press macros. When not available, you must manually change or remove Zen macros. See our Zen Macro Migration for more information.

Expand

title	Custom CSS and

JavaScript

Javascript

After migrating, manually add your custom CSS and/or JavaScript to Theme Press. You may need to update this code.

Expand

title	Cascading Menus

Theme Press does not support cascading menus. Therefore, Theme Press ignores any second level items in migrated menus. Try

menu panels

panel menus or secondary menus instead.

Review this list to learn which Zen Foundation macros you can migrate to Theme Press.

Content Block

name	Macro Migration
id	746164931

Zen Macro

Migrate to...

active-button

action-button

active-image

rollover-image-link

add-class

html-add-class

attachments-list

list-attachments

blog-link

html-link

body-class

html-add-class

clear

html-clear

click-element

html-link

copy-element

html-copy-element

disappear

expand

facebook-likebox

widget connector

flexible-link

html-link

gallery-scroller

gallery

greeting

hello

hide-page-title

remove

include-multi-page-content

include-content

include-section

include-content

new-window

target-new

page-tree

pagetree

page-turners

page-turner

random-content

rotate-content

redirect

remove

restrict

restrict-content

restrict-section

restrict-content

reveal

expand

rotate-images

rotate-content

rss-feed-link

html-link

same-window

target-current

seo-meta-description

remove (not compatible yet)

seo-title

remove (not compatible yet)

simple-children

list-children

simple-favorites

list-favorites

simple-space-list

list-spaces

space-description

display-space-description

space-name

display-space-name

timezone-selector

choose-timezone

toggle-label

remove

twitter-feed

widget connector

whole-section-link

block-link

wide-screen

remove

wrap

html-wrap

zen-button

action-button

zen-master

remove

zen-section

content-block

Content Block

name	Logs
id	746171661

Getting Started
rich-link-hovers	true
id	766742158
class	manual-outcome-flex

Getting Started

Accessing the Migration Page

Once you install the Zen Migrator App, complete the following:

Navigate to General Configuration under the Confluence Administration Menu.
Locate the Zen Migrator section on the left.
Click the Migrate Zen Foundation to Theme Press link.

HTML Wrap

class	docs-screenshot

Image Added

Monitoring Your Progress

As you move through the migration process, a log appears to the right of the screen. Use this section to monitor your progress and any issues that may arise. You can download these logs if necessary.

HTML Wrap

class	docs-screenshot

Content Block

name	Extra Title
id	781286973
class	manual-outcome-flex tight-bottom

Running the Migration

Where do I find the architect pages?

You find the architect pages in the Theme Press Default space. The title of each page includes the name of its space.

(Admin-notice pages are converted to banner architect pages.)

Migrate Overriding Layouts

For each unique Zen layout that overrides the master, the migrator generates a Theme - Press layout page. In other words, if two or more Zen pages use the same type of layout, the migrator creates only one layout page in Theme Press. The migrator also applies these layouts to the appropriate pages.

Where do I find these layout pages?

You find the layout pages in the

(In Theme Press, layouts are found in the Theme Press Default

space

Space.)

Content Block

padding	0 40px 32px 40px
name	Steps
id	746181021
class	steps-block numbered

Select Scope

Before initiating any steps, you should set the scope of the migration. First, determine if you want to migrate all space spaces or Zen-only spaces. Select all spaces if:

all spaces in your site use Zen
some spaces use Zen and other spaces formerly used Zen
some spaces use Zen and other spaces contain pages using Zen macros

Next, select a processing mode: migration vs. audit.

Migration mode completes the conversion during each step.
Audit mode simulates the conversion and generates an audit log.

Migrate Zen Pages

During this step, the migrator replicates each Zen page as a Theme a Theme Press architect page. Afterward, the migrator assigns a site default for each type of architect page (banner, header, menu, layout, footer). Additionally, the migrator looks for any space overrides and applies those pages accordingly.

Info

Admin Notice Page

For the admin-notice page, the migrator creates a banner architect page.

Info

How do I know which pages use these layouts?

You can view the usage of each layout page in the Designer. Review the Layout Usage tab for information.

Migrate Brands

You have the option of migrating You can migrate Zen brands to Theme Press themes. Just select the appropriate brands. Note, you cannot migrate built-in brands.

Info

HTML Wrap

class	docs-screenshot

Migrate Zen Macros

During this step, the migrator finds all pages using Zen macros. Upon building the list, you'll see a blue action circle ( ) next to each macro that is ready for conversion. Click this icon to replace the Zen macro with a Theme Press equivalent. You must manually convert or remove all other macros.

You can find a full list of Zen Macros and their Theme Press equivalents here.

Tip

When in audit mode, be sure to click the blue action circle for the following macros:

include-section
simple-space-list
zen-section

This step adds helpful information to the audit logs.

Info

How do I find pages using these Zen macros?

Click the blue arrow next to the name of each Zen macro that shows results.

HTML Wrap

class	docs-screenshot

Apply Theme Press

Now that you've migrated your brands and Zen pages, you should apply Theme Press and the resulting themes. For each space, migration involves:

applying Theme Press as the site or space theme
assigning a site default theme
assigning any themes that override the site default

Info

Built-in Brands

If using a built-in brand as the default, the migrator sets the Theme Press default theme to Indigo Splash. This step is necessary because you cannot migrate built-in brands.

Create and View Punch List

As you complete this conversion, the migrator builds a list of items you should review and fix.

Content Block

name	Punch List
id	746188623
class	tight-bottom

Manual Changes

Once you generate the punch list, you'll see several items that require manual changes. Some relate to migrated brands. Others relate to , involving migrated brands, as well as pages and layouts.

Info

Support

If you need help with your punch list, please contact Brikit support.

Migrated Brands

When migrating a brand, the punch list shows tasks for brand settings that (1) need review or (2) cannot be migrated. Each item shows a brand setting reference that begins with a dollar sign ($).

Pages and Layouts

When viewing the punch list, review the following tasks related to pages and layouts:

check layout format
review layout (floating sections)

The punch list provides a link for each page that you may need to fixadjustment. Most likely, these pages previously contained floating or tabbed sections.

info

Expand

title

	Floating Sections

We refer to In Zen, columned sections are referred to as floating sections. Each floating section migrates into its own layer/column/block when migrating to Theme Press. If a Zen page contains two floating sections (section 1 and section 2), the migrated Theme Press page will then contain the following:

one layer/column/block for section 1
another layer/column/block for section 2

Expandinfo

title	Tabbed Sections

Each tabbed section migrates into its own layer/column/block. Note: In Theme Press, while tabbed blocks on 'normal' content pages work much like Zen, you cannot create tabbed blocks in on Theme Press layout pages.

Manual Changes

Adding Columns and Layers

You can fix may need to adjust affected pages so that content appears in columns. When doing so, you may need to add , either by adding additional columns to a layer or create creating a new layer (with several desired number of columns). Once you create new columns, drag and drop your content into the appropriate areas. You can also create tabbed blocks when needed.

Info

How-to

See the following reference material for help.

Content Block

name	Tip
id	753082755
class	manual-outcome-flex tight-bottom

Tip

Need help with your punch list?

Action Button

text	Contact Brikit Support
url	https://support.brikit.com/secure/Dashboard.jspa

Content Block

name	Remove Zen
id	746195299

We recommend you disable Zen Foundation upon completing the migration steps and checklist. Once you determine the migration is successful, uninstall the add-on.

Content Block

name	Common QuestionsWarning
id	749435771	782567768
class	manual-outcome-flex tight-bottom

Note

Before migrating your production server, be sure to:

Verify your results in a test environment
Backup your site and verify the validity of the backup

Disabling Zen

We recommend you disable Zen Foundation upon completing the migration steps and checklist. Once you determine the migration is successful, uninstall the add-on.

What's Happening to Zen Foundation?

Theme Press is our next-generation theming product for Confluence, which will eventually replace Zen Foundation. However, we will continue to support and upgrade Zen Foundation for new Confluence versions for a couple more years, though improvements will be limited to bug fixes and compatibility upgrades.

We will be encouraging Zen Foundation users to migrate to Theme Press, as well as providing tools to facilitate this migration.

Does Theme Press Have All of Zen's Features?

Largely, Theme Press has Zen's features (and then some), with one exception: the drafts and publishing features are not included in Theme Press.

Drafts and publishing features will be available in a separate add-on (Content Flow), which will include additional features such as content routing and scheduling.

Will You Need to Buy a Theme Press License?

If you have a commercial or academic Zen Foundation license with a current maintenance contract, we will issue free matching licenses for both Theme Press and Content Flow on request. These licenses will appear in your my.atlassian.com account alongside your Zen Foundation license.

Can You Install Theme Press and Zen Foundation in the Same Environment?

Yes, but you will need to use Theme Press version 1.1.5 or later and Zen Foundation 5.2.16 or later. Earlier versions ran into a theme-management bug in Confluence.

Should You Migrate?

If you've followed the decision tree on our Products page, you know you're able to switch to Theme Press if:

You're using Confluence 5.3 or greater, AND
You don't need Zen's drafts and publishing feature (or can wait until the fall)

How Does Migration Work?

We are building and testing tools to automatically migrate:

Zen macros to their Theme Press equivalents
Zen master page and page layouts to Theme Press equivalents
.zen pages into their Theme Press equivalents
Your custom Zen brand to a Theme Press theme (excluding custom CSS and JavaScript you may have added)
- Note: if you have a current Zen brand maintenance contract, we will upgrade your brand for you

The process will be approximately:

Clone your production server to a test server, on which you'll
Install Theme Press
Install the migrator tool
Disable Zen Foundation
Run the steps described the migrator tool
Spot check the results

When Will the Migrator be Available?

The migrator is available now. Please contact us to learn more.

Can Brikit Perform the Migration for My Site?

As we test the migrator on ourselves and Atlassian, we will be defining a service package to offer to customers who would like us to help. This service package will also be available through our global network of Atlassian Expert Partners. Pricing and service timing is TBD.

Content Layer

background-color	$lightGrayColor
name	Related
id	888168050

Content Column

name	Related
width	100%
id	888168051

Content Block

rich-links-hide-description	true
rich-link-hovers	true
rich-links-columns	4
rich-links-vertical	true
rich-links-image-height	100px
rich-links-hide-site-icon	true
rich-links-details-padding	10px
name	Related
rich-links-enable	true
border-width	0
rich-links-details-alignment	left
rich-links-margin	20px 30px 0 0
id	496234544
class	related-block clean manual-related-flex

Page tree

Transform Your Digital Workplace

Industry Expertise

Inform Your Strategic Direction

Redefining Work

Documentation and Support

Versions Compared

Old Version 77

New Version Current

Key

The Basics

Before you migrate, review the following information.

Migration Page

Layouts Overriding Master Layouts

Getting Started

Accessing the Migration Page

Monitoring Your Progress

Running the Migration

Select Scope

Migrate Zen Pages

Admin Notice Page

Where do I find the architect pages?

Migrate Overriding Layouts

Where do I find these layout pages?

How do I know which pages use these layouts?

Migrate Brands

Migrate Brands

Where do I find these themes?

Migrate Zen Macros

How do I find pages using these Zen macros?

Apply Theme Press

Built-in Brands

Create and View Punch List

Manual Changes

Support

Migrated Brands

Pages and Layouts

Adding Columns and Layers

How-to

What's Happening to Zen Foundation?

Does Theme Press Have All of Zen's Features?

Will You Need to Buy a Theme Press License?

Can You Install Theme Press and Zen Foundation in the Same Environment?

Should You Migrate?

How Does Migration Work?

When Will the Migrator be Available?

Can Brikit Perform the Migration for My Site?

Platform

Company

Support

Brikit Services