<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=749646578535459&amp;ev=PageView&amp;noscript=1">
Skip to content
Submit a Support Ticket Sign in
  • There are no suggestions because the search field is empty.

Troubleshooting Freestyle Card Iframes

Follow these steps to troubleshoot common issues with embedding external websites and content in Freestyle Cards.

Freestyle Cards in KaiNexus allow you to embed external websites, dashboards, or documents directly into your Boards. However, because iframing involves two different systems "talking" to each other, security settings and other configuration issues can sometimes block the content from appearing.

If your Freestyle Card is blank or showing an error, follow these troubleshooting steps:

1. Use an embed link (if available)

A common issue with iframes is using a standard page URL instead of a link designed for embedding.

While some websites allow standard URLs to be embedded, many platforms provide a dedicated embed link or embed code that is specifically formatted to work in an iframe. Using these links typically results in better compatibility and display.

  • If an embed link or code is available, paste it directly into the Freestyle Card’s code view.

  • If you're unsure whether your content supports embedding or where to find the embed link, refer to the source platform’s help center or documentation.

2. Check your Iframe HTML

If your platform doesn’t provide a pre-made embed code, you’ll need to write the iframe HTML manually in the Freestyle Card’s code view. Even a small typo can prevent the iframe from loading correctly.

Ensure your code follows this format: 

<iframe src="https://www.yourlink.com" width="100%" height="600px"></iframe>

Tips to avoid errors:

  • Ensure theURL is enclosed in quotes and the closing </iframe> tag is included.
  • Adjust the width and height values so your content fits inside the Card.
  • Make sure the URL starts with https:// for secure embedding.     

3. Verify your credentials and access

If the site you’re embedding is not public—like a private SharePoint file or a protected Google Doc—the browser needs to verify your credentials before showing the content.

If you're already logged in to the source platform in the same browser, you should be automatically signed in. Otherwise, you’ll see a login page to enter your credentials.

If verification fails, the Card may display an "Access Denied" message. In this case you should: 

  • Check the content’s share settings to ensure it’s set to Public or Anyone with the link. Some platforms require an extra step to Publish content before it can be embedded.
  • Contact your internal admins for the source platform to confirm you have the correct credentials and access permissions.

4. Confirm the site allows embedding

Some websites explicitly forbid being "iframed" on external platforms for security reasons.

If this is the case, you'll see a "Refused to Connect" message or a blank gray box on the Card. In this case you should: 

  • Contact the platform’s support team or your internal IT department to confirm if the site is embeddable.

  • If embedding is restricted, ask if your KaiNexus domain can be added to the site’s allow-list.

5. Contact KaiNexus Support

If you have verified the HTML code, confirmed the site allows embedding, and ensured your credentials are correct, but the content still won’t load, our support team is happy to take a look.

To help us troubleshoot quickly, please submit a support ticket with the following information:

  1. The Embed Code/HTML: The exact link or code snippet you are trying to use.

  2. Location: The name of the Board and the specific Freestyle Card where the issue is occurring.