Child pages
  • Documentation Theme Migration FAQ
Skip to end of metadata
Go to start of metadata

In preparation for an upgrade to the Wikis @ UAlbany service, we have found that the Documentation theme will no longer be available after the upgrade.  Any wiki spaces that previously used the Documentation theme will be migrated to the default theme prior to the upgrade.

Here are some questions you may have about this change:

How can I check if I am using the documentation theme in my space? 

The easiest way to check whether your space is using the documentation theme is to look for a Browse menu in the header, near the Create button.  (If you're using the default theme already, you'll see a Space Tools menu at the bottom of the sidebar instead.)

Can I still use macros in my sidebar, header or footer?

Yes! If a macro worked correctly in the documentation theme it'll work in the default theme too. 

Where should I add custom content to the sidebar, header or footer?

You can add custom content to the sidebar, header and footer in each space individually (Space Tools > Look and Feel > Sidebar, Header and Footer) or globally (Gear iconGeneral Configuration > Sidebar, Header and Footer).

Confluence displays global custom content in all spaces, except where a space has its own custom content defined (space custom content overrides global custom content).  This behavior applies field by field, so a space can display a combination of custom content.  For example you could define the content of a footer globally, and content of a header in each space individually, or only in some spaces. 

How do I turn off the Pages and Blogs shortcuts at the top of the sidebar?

Go to Space Tools > Configure Sidebar and use the + and x icons to hide any items you don't want to see. 

I want to see the page tree, not child pages. how do I do this?

Head to Space Tools > Configure Sidebar and select Page Tree in the navigation options.   The default for all new spaces is Page Tree.  

Where is Space Administration and Space Operations?

Instead of choosing between Space Operations and Space Administration, the documentation theme has a single Space Tools menu that lets you jump right to Permissions, Content Tools, Look and Feel, or Integrations.

Other Space Operations locations:

Old Space Operations locationNew Location in the sidebar
Browse > PagesPages on the sidebar or Space Tools > Reorder pages
Browse > BlogsBlogs on the sidebar
Browse > Labels
Click a label on any page, then use the  menu to see all labels, popular labels or pages from other spaces
Browse > Space Operations > Space DetailsSpace Tools > Overview
Browse > Space Operations > Orphaned PagesSpace Tools > Content Tools > Orphaned Pages
Browse > Space Operations > Undefined PagesSpace Tools > Content Tools > Undefined Pages
Browse > Space Operations > AttachmentsSpace Tools > Content Tools > Attachments
Browse > Space Operations > PDF, HTML, XML ExportSpace Tools > Content Tools > Export
Browse > Space Operations > RSS FeedsSpace Tools > Content Tools > RSS Feeds
Browse > Space Operations > Watch this spacePages > Watch this space (or use the Watch button on any page)
Browse > Space Operations > Watch this blogBlogs > Watch this blog (or use the Watch button on any blog post)
Browse > Space Operations > Remove from My Spaces
Use the  icon in the sidebar (or in the space directory)

Browse > Space Admin > Space Details

Space Tools > Overview
Browse > Space Admin > Space CategoriesSpace Tools > Overview
Browse > Space Admin > TemplatesSpace Tools > Content Tools > Templates
Browse > Space Admin > Delete SpaceSpace Tools > Overview > Delete Space
Browse > Space Admin > TrashSpace Tools > Content Tools > Trash
Browse > Space Admin > PermissionsSpace Tools > Permissions
Browse > Space Admin > Restricted PagesSpace Tools > Permissions > Restricted Pages
Browse > Space Admin > Application linksSpace Tools > Integrations > Application Links
Browse > Space Admin > ThemesSpace Tools > Look and Feel > Themes
Browse > Space Admin > Color SchemeSpace Tools > Look and Feel > Color Scheme
Browse > Space Admin > PDF LayoutSpace Tools > Look and Feel > PDF Layout
Browse > Space Admin > PDF StylesheetSpace Tools > Look and Feel > PDF Stylesheet
Browse > Space Admin > Change Space LogoSpace Tools > Configure Sidebar then choose the edit icon on the space logo

Do I have to use wiki markup in the sidebar, header, and footer?

Yes. The main focus when adding this feature was to help people move from the documentation theme to the default theme with a minimum of effort. Keeping these fields as wiki markup means that your existing customizations can be pasted straight in. 

Can I hide or change the space logo appearance?

You can upload any image to use as your space logo, but you can't change how it appears in the sidebar (it's always round and always at the top). 

Can I hide the built in page tree and insert my own? 

Yes. If you want to have complete control over how the page tree appears in your sidebar you can hide the built in page tree, and then add a Page Tree macro {pagetree} in the sidebar custom content. 

How can I make my page titles wrap in the sidebar?

Page titles do not wrap in the sidebar of the default theme (regardless of whether you're using the built in page tree or have added a {{pagetree}} macro as custom content). There's no way to change this.

Can I change the order in which things appear in the sidebar?

You can change the order of some items in the sidebar, such as the shortcuts, but the order of the sections themselves can't be changed. Anything that has an icon of 3 horizontal bars can be moved. 

Custom content appears above the page tree.  You have the option to hide the built in page tree, and then add it back in the custom content area using wiki markup. This can be useful if you want more control over the order of the page tree and your custom content.

Why don't child pages appear below the page?

The default theme does not list child pages below the page content, but includes it instead in the sidebar. You can achieve a similar result to the Documentation Theme by adding a Children Display macro to the footer.

Old view

New view

Expanded sidebar viewCollapsed sidebar view

Can I restrict search to just this space?

No, that is one of the features removed with the documentation theme.  One workaround is to add a Livesearch macro to the sidebar or space homepage. Use @self in the spaces parameter to restrict the search to the current space.

How do I view the pages in my space alphabetically?

The default theme does not have an option to view all pages in your space alphabetically.

Need more help? Contact the ITS Service Desk.