Skip to content
Documentation
Mini Program ManagementTroubleshooting

Troubleshooting

Troubleshoot common issues when embedded mini program pages fail to load, including X-Frame-Options restrictions.

When embedding webpages in mini programs, you may encounter pages failing to load. Use the guidance below.

Error: Refused to connect This typically means the target site has restrictive security policies.

  • Cause: The target site sets X-Frame-Options: SAMEORIGIN or DENY in HTTP headers, which forbids iframe embedding (including Cherry Studio's container).
  • Solutions:
    1. Contact the site owner: For internal systems, ask ops to allow embedding from the Cherry Studio domain or Electron container.
    2. Use an embed URL: Some AI providers offer specific embed links.
    3. Check protocol: Ensure the URL starts with https.

Best practice Before rolling out to everyone, create a test mini program and verify the link opens and works in the client. If it works, rename and enable it for production use.

Edit and Maintain

Update custom mini program settings such as URL and logo, or delete programs no longer needed.

Knowledge Base Management

Vectorize enterprise documents, web pages, and notes so AI can answer based on internal facts and reduce hallucinations.

On this page

Troubleshooting