Restricted spaces during a Toolkit migration - May 2025

Restricted spaces during a Toolkit migration - May 2025

Refined cannot auto-migrate content created within the Page Builder in restricted Space Overview Pages. This is because the Overview Page has been restricted to certain users, and the Refined UI Toolkit app will thus not be able to access or edit the page. The possible solutions you will need to look into applies if you:

 

  1. Have a restricted Space Overview Page (meaning it’s not editable except by the space owner or specific users)

  2. The Space Overview is enabled (under Space Settings > Theming > Configure Refined Toolkit)

 

The 4 different solutions you can choose from are:

 

  1. Do nothing

If the space is not used, or you for other reasons do not want to migrate the content, doing nothing and just starting the migration to the new UI Toolkit application is your next step.

Important note: If you go through with the migration without taking any action, your content will be difficult to retrieve.

 

  1. Disabling the restriction on the Space Overview Page

You can remove the restriction on the Space Overview Page, and by that the contents added to the Page Builder will automatically be a part of your migration. If you want a step-by-step of how to do this follow the video below.

Important note: If you remove the restriction, any user in that space would be able to view/edit the content of the Space Overview Page.

open_restriction_for_enabled_spaceoverview.mov

 

  1. Exporting/Importing Layout in UI Toolkit App:

If you don’t want to remove the restriction on the Space Overview but want to keep the content, you can export the content from the old Toolkit app and then import it to the new UI Toolkit app. Follow these steps and/or follow the videos below:

In the old app:

  1. Open the Space Overview Page Builder

  2. Click Edit button for the Page builder

  3. Open the side menu and export the layout.

In the new app:

  1. Go to the “restricted“ Space Overview Page

  2. Edit the page

  3. Add the Page Builder to the Space Overview

  4. Open the Page Builder editor

  5. Go to the side menu and import the layout from step 3

  6. Save and publish the changes

Steps to export Layout from a Space Overview Page Builder

Steps to import layout to a Space Overview Page Builder

Steps to export Layout from a Space Overview Page Builder

Steps to import layout to a Space Overview Page Builder

exporting_layout.mov
Import_layout.mov

 

  1. Converting the Page Builder Space Overview to a Page Builder Macro

If you don’t want to remove the restriction on the Space Overview but want to keep the content, follow these steps below:

  1. Open the Space Overview Page Builder

  2. Click Edit button for the Page Builder

  3. Open side menu and export the layout

  4. Disable Space Overview under Refined settings

  5. Open the Space Overview Page

  6. Click edit and add Page Builder Macro

  7. Open the Page Builder macro settings and import layout from step 3

  8. Save and publish changes

  9. Switch to the new UI Toolkit app, and the Page Builder Macro will be successfully migrated