Tokens - Migrate Portal Specific Namespaces to Global Namespaces
Audience:
Citizen Developer
Skill Prerequisites:
Tokens
,Namespaces
How to Resolve Namespace Conflicts and Migrate to Global Namespaces in Plant an App
Release: 1.27 — Portal specific Namespaces are Obsolete and will be removed in a future version.
Watch the video demonstration here
Overview
In Plant an App release 1.27, you may observe the following warning in configuration tokens:
“Portal specific namespaces are obsolete and will be removed in a future version. Read more.”
This message indicates a need to transition from portal-specific namespaces to global namespaces. This article will guide you through:
- Why this change is necessary
- How to resolve namespace conflicts
- How to migrate to global namespaces when no conflicts exist
Why are Portal Specific Namespaces Obsolete?
Originally designed for DNN Sharp / DNN sites, portal-specific namespaces allowed for multiple "portals" in a single installation, each with potentially unique tokens. With the unified Plant an App environment, the expectation is a cohesive system where all tokens are globally available for consistency and predictability.
If you previously utilized tokens with the same name but different definitions across portals, you'll need to reconcile these setups.
Identifying Portal-Specific Namespaces and Conflicts
Navigate to Configuration > Tokens to inspect your namespaces. Portal-specific namespaces display a warning:
Portal specific Namespaces are Obsolete and will be removed in a future version. Read more.
For each marked namespace, investigate for conflicts. Conflicting cases arise when tokens with the same name contain different definitions across portals.
Resolving Namespace Conflicts: Step-by-Step
1. Open the Namespace for Editing
- Go to Configuration > Tokens
- Identify namespaces with warnings
- Click the View Namespace button, followed by Edit
2. Evaluate Token Definitions Across Portals
- Examine token definitions within the namespace across all portals
- If definitions match across portals:
- Proceed to delete redundant token entries on sub-portals
- Ensure the main portal contains the correct definition
3. Enable Global Availability
- On the main portal, turn on the "Available on all portals" switch
- Click Update to complete the migration to a global namespace.
4. Different Definitions
If definitions differ:
- Rename tokens on one or multiple portals to resolve conflicts
- Ensure the main portal holds the primary token definition
- Repeat until all conflicts are eliminated
5. Consolidate and Delete
- After resolving definitions,
- Merge unique tokens into a single global namespace
- Delete old portal-specific namespaces
Once updated, portal-specific setup can no longer be configured, aligning with Plant an App's goal of a unified namespace environment.
Key Considerations
- Conflict Resolution: If conflicting token definitions exist, reconcile these by renaming and reconfiguring as necessary.
- Unified System: All tokens/namespaces must be available everywhere, ensuring consistent functionality.
FAQ
Q: What happens if I take no action?
A: Future updates will render portal-specific namespaces non-functional, potentially causing application errors where tokens don't resolve correctly.
Q: Is this change reversible?
A: No, once a namespace is global, it cannot be returned to a portal-specific state.
Summary
Moving to global namespaces ensures Uniformity and aligns Plant an App with a single-system vision.
Resolve namespace conflicts and migrate to global namespaces to secure your configuration against future platform updates.
For more details, see the video walkthrough
Revised 09/12/2025