/
Replace Subspace Macro with Navigation Macro

Replace Subspace Macro with Navigation Macro

Problem

  • I think the macro "SubSpace" has been replaced by the "Navigation" macro in the last release of space navigation. How do I replace the old with the new macro? OR

  • I get the message Unknown macro: 'SubSpaces'

Solution

With version 3.1 we brought the most used macro back: Subspaces. But now it is called "Navigation".

Since Confluence offers built-in methods to search the current space the macro "subspaces-quicksearch" is not part of SubSpace Navigation for Confluence. To remove this macro on every page do the following:

  1. Find all pages where the Subspace Quicksearch Macros are used

    • enter in the Confluence search box: macroName:subspaces-quicksearch*

  2. edit the pages and remove the macro "subspaces-quicksearch"

In order to replace the outdated "subspace" macro with the new "Navigation" macro you need to do:

  1. find all pages where the former "Subspace" Macros are used

    • enter in the Confluence search box: macroName:subspaces*

  2. edit the pages and remove the old macro "subspaces"

  3. add the new macro "Navigation"

  4. set the parameter "Start element" to the current space

Related Articles



Related content

Export/import configuration from SubSpace Navigation
Export/import configuration from SubSpace Navigation
Read with this
Hide navigation in Confluence header
Hide navigation in Confluence header
Read with this
Spaces are reset after migration from 2.2.2 to 3.x
Spaces are reset after migration from 2.2.2 to 3.x
Read with this
Navigation color is wrong after update to version 3.3
Navigation color is wrong after update to version 3.3
Read with this
Hide Navigation menu entry for specific groups
Hide Navigation menu entry for specific groups
Read with this
Error when trying to add space element to navigation
Error when trying to add space element to navigation
Read with this