Troubleshooting Siteimprove Adobe Universal Editor Extension Installation and Deployment Issues

Problem

You are unable to see, deploy, authenticate, or use the Siteimprove extension for Adobe Universal Editor as expected.

Applies To (Environment)

Symptoms

You may experience one or more of the following issues:

• The Siteimprove extension does not appear in Extension Manager
• aio app deploy fails with an authentication error
• The App Builder template is not available when creating a project
• The Siteimprove panel is visible but shows no results
• The sign‑in popup does not close automatically
• Environment variable values are not applied during deployment

Possible Causes

These issues are typically caused by:

• Incomplete or failed deployment
• Expired or missing authentication
• Missing Adobe App Builder entitlement
• Browser restrictions (pop‑ups blocked)
• Incorrect project or workspace selection
• Environment configuration issues

Resolutions

Use the section below that matches your issue.

Issue: Extension not visible in Extension Manager

Resolution

• Confirm that aio app deploy completed successfully without errors.
• Verify that App Builder entitlement is active for your organization.

Issue: aio app deploy fails with authentication error

Resolution

• Run aio login again.
• Re‑select the project and workspace:
• aio console project select
• aio console workspace select
• Re‑run the deploy command.

Issue: App Builder template not available

Resolution

• Confirm that your organization has Adobe App Builder entitlement.
• If not entitled, contact your Adobe Technical Account Manager (TAM) or apply for a trial at: developer.adobe.com/app-builder/trial

Issue: Panel visible but no results shown

Resolution

• Ensure the AEM page is published and reachable by Siteimprove.
• Wait a few minutes after first sign‑in, as initial analysis results may take time to appear.

Issue: Sign‑in popup does not close automatically

Resolution

• Allow pop‑ups for experience.adobe.com in your browser settings.
• Retry the sign‑in process.

Issue: .env values not picked up during deploy

Resolution

• Confirm the .env file is located in the project root (same level as package.json).
• Re‑run:
• aio app deploy

Expected Result

After applying the appropriate resolution:

• The extension appears in Extension Manager and can be enabled
• Deployment completes without errors
• Authentication succeeds
• The Siteimprove panel displays results in the Universal Editor

Validation / Confirmation

You can confirm the issue is resolved if:

• The Siteimprove extension is visible and enabled
• aio app deploy completes successfully
• Content checks return results in the Siteimprove panel
• No authentication or popup‑related interruptions occur

Additional Information

Common pitfalls

• Using the wrong Adobe Developer Console workspace
• Missing App Builder entitlement
• Browser popup blockers preventing authentication flows

Tips

• Use the Production workspace for live deployments
• Verify pop‑up behavior before retrying authentication
• Re‑authenticate with aio login if any deploy errors occur