1. Unable to Access Data Activation Layer in Stack Settings
Summary
Users may find that they cannot access the Data Activation Layer (DAL) within individual stack settings, even if the feature is enabled for the account. This prevents the configuration of data activation features.
Root Cause
The Data Activation Layer is an organization-level configuration rather than a stack-level setting. The issue typically arises from a misunderstanding of the feature hierarchy.
Resolution
- Navigate to the Organization Admin settings instead of individual stack settings.
- Locate the Data Activation Layer section within the organization-level configuration menu.
- Verify that the necessary permissions are active at the organization level to view the feature.
Verification
After navigating to the Organization Admin settings, check for the Data Activation Layer option. If the feature is visible and accessible in this location, the issue is resolved.
2. Difficulty Activating Data Layer Without Launch Project Selection
Summary
Activating the Data Layer in Personalize may appear to require a Launch project selection, even when using external tools like Google Tag Manager. This prevents setup completion if Launch is not part of the tech stack.
Root Cause
This issue is caused by client-side caching.
Resolution
- Check the current browser cache and clear it to ensure the latest interface state is loaded.
- Attempt to activate the Data Layer without selecting a Launch project to verify if the requirement persists.
- Coordinate a troubleshooting call to observe the behavior in real-time if the interface does not allow progression.
Verification
After clearing the client-side cache, navigate to the Data Layer activation screen. If the Data Layer can be activated without selecting a Launch project, the issue is resolved.
3. Authentication Failure for Certification Portal Access
Summary
Accessing the Data & Insights Practitioner Certification portal may fail if the user's account is not correctly associated with an active Contentstack Organization. This prevents practitioners from completing certification milestones despite having valid Partner Hub credentials.
Root Cause
The issue is caused by a missing Organization (ORG) association. Even with access to external partner tools, the certification portal requires the user to be a member of a registered Organization within the Contentstack ecosystem to validate identity and permissions.
Resolution
- Check if the user is attempting to use Partner Hub credentials on the certification portal without being linked to an ORG.
- Verify the user's account status in the internal system to see if they are a member of any active Organization.
- If no Organization is found, advise the user to contact their internal Organization administrator to be added as a member.
- If the user is the primary contact for a new organization, initiate the standard onboarding or invitation process to establish the Organization link.
4. Role Restriction Error When Accessing Data & Insights Tab
Summary
Users assigned to the "Member" role at the organization level may be blocked from accessing the Data & Insights (D&I) tab within Personalize. This results in a "role restriction" error, preventing users from viewing audience analytics.
Root Cause
The issue is caused by insufficient role privileges. The standard "Organization Member" role does not include the necessary permissions by default to authenticate into the integrated Lytics environment that powers Data & Insights.
Resolution
- Confirm the user is encountering a "role restriction" error when attempting to access the Data & Insights tab.
- Verify the user is assigned the "Member" role at the organization level.
- Coordinate with the Lytics engineering or support team to generate a manual OAuth login link specifically for the affected user.
- Provide the generated OAuth link to the user to bypass the standard UI authentication restriction.
Verification
Provide the user with the OAuth link and ask them to attempt access. If the user successfully reaches the Data & Insights dashboard, the issue is resolved.
5. Conditional Rules Failing to Hide File Field Options
Summary
Configuring conditional rules in Personalize may fail to hide specific options, such as "transparent background," when field-level validations are active. This prevents the enforcement of UI logic intended to restrict choices based on a selected variant.
Root Cause
The issue is caused by a system limitation where active validations on a file field interfere with the ability of conditional rules to hide or modify available options.
Resolution
- Navigate to the content type or field settings and temporarily remove all validations from the affected file field.
- Create and save the conditional rule intended to hide options for the specific variant.
- Re-enable the previously removed field-level validations.
- Verify that the rule remains active and functional after the validations are restored.
Verification
After temporarily removing validations and setting the rule, navigate to the entry editor and select the target variant. If the specific file field options are successfully hidden while validations are active, the issue is resolved.