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:
Have a restricted Space Overview Page (meaning it’s not editable except by the space owner or specific users)
The Space Overview is enabled (under Space Settings > Theming > Configure Refined Toolkit)
The 4 different solutions you can choose from are:
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.
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.
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:
Open the Space Overview Page Builder
Click Edit button for the Page builder
Open the side menu and export the layout.
In the new app:
Go to the “restricted“ Space Overview Page
Edit the page
Add the Page Builder to the Space Overview
Open the Page Builder editor
Go to the side menu and import the layout from step 3
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 |
---|---|
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:
Open the Space Overview Page Builder
Click Edit button for the Page Builder
Open side menu and export the layout
Disable Space Overview under Refined settings
Open the Space Overview Page
Click edit and add Page Builder Macro
Open the Page Builder macro settings and import layout from step 3
Save and publish changes
Switch to the new UI Toolkit app, and the Page Builder Macro will be successfully migrated