How to Embed a Widget on Circle

Circle.so is a modern community platform used by creators, educators, and brands to build engaged online communities. This guide shows you how to embed interactive Embeddy widgets — such as quizzes, polls, and calculators — in your Circle community posts and space pages.

Beginner~5 min readUpdated 2026

On this page

Prerequisites

Before you embed your widget, you need two things:

  • Your Embeddy embed code. Log in to your dashboard at https://embeddy.ai/dashboard, open your widget, and copy the iframe embed code. It looks like this:
<iframe
  src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID"
  width="100%"
  height="500"
  frameborder="0"
></iframe>
  • Circle community admin or moderator access. Community admins can embed custom HTML in posts and space settings. Regular members may have limited embed capabilities depending on your community settings.

Embedding in Posts

Circle's rich post editor supports embed blocks that can render iframes and third-party content inline within a post. This is the most common way to share interactive widgets with your community members.

  1. 1

    Create a new post

    Navigate to the space where you want to post and click New Post or Create Post.

  2. 2

    Add an Embed block

    In the post editor, type /embed or click the + button in the editor toolbar and select "Embed" or "Custom HTML".

  3. 3

    Paste your embed code

    Paste the Embeddy iframe code into the embed block. Circle will process the HTML and display a preview of the embedded content.

  4. 4

    Publish the post

    Add any additional text or context around the widget, then click Publish to share it with your community.

Tip: Circle supports embedding from many providers via URL paste (similar to oEmbed). If pasting the full iframe code does not work, try pasting just the src URL from your iframe into the embed block.

Community engagement tip

Embed interactive quizzes or polls in your community posts to drive engagement. Members are more likely to interact with a post that contains an interactive element rather than just text.

Space Landing Pages

Circle spaces can have customizable landing pages. As a community admin, you can add embed blocks to space descriptions and landing page content.

  1. 1

    Open space settings

    Navigate to the space you want to customize and click Space Settings (gear icon).

  2. 2

    Edit the landing page content

    In the space settings, find the description or landing page editor. Use the embed block to add your Embeddy iframe code.

  3. 3

    Save changes

    Click Save to publish the changes. The widget will appear on the space landing page for all members.

Custom HTML (Admin)

Circle provides community-wide custom code injection for admins. This allows you to add scripts or embeds that appear across the entire community.

  1. 1

    Go to Admin Settings

    As a community admin, navigate to Admin > Settings > Custom Code.

  2. 2

    Add your code

    Paste your embed code in the Head or Body code section. This is best for site-wide scripts rather than individual widgets.

Note: For individual widgets, prefer embedding in posts or space pages. Custom code injection is best for analytics scripts and community-wide utilities.

Iframe Embed Code Example

Here is what a complete Embeddy iframe embed looks like for Circle. Copy your specific code from the Embeddy dashboard — the WIDGET_ID and PROPS_ID values will be filled in automatically.

<!-- Embeddy widget embed — paste into Circle Embed block -->
<iframe
  src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID"
  width="100%"
  height="500"
  frameborder="0"
  style="border: none; border-radius: 8px;"
  loading="lazy"
  title="My Embeddy Widget"
></iframe>

You can adjust height to match your widget's content. Use width="100%" to make the embed responsive across all screen sizes.

Troubleshooting

The embed block does not accept my iframe code

Circle's embed block may only accept URLs rather than raw HTML in some configurations. Try pasting just the src URL from your iframe. If your Circle plan supports custom HTML blocks, use that option instead.

Widget shows a blank area

Verify your Widget ID and Props ID in the embed URL are correct. Open the Embeddy dashboard and copy the embed code fresh. Confirm the widget is published (not in draft mode).

Embed is not available for regular members

By default, Circle may restrict embed blocks to admins and moderators. If you want members to embed content, check your community settings under Member Permissions.

Widget is cut off or too small

Increase the height attribute in your iframe code. Circle posts have a fixed content width, so use width="100%" to fill the post container.

Frequently Asked Questions

Can community members interact with embedded widgets?

Yes. Embedded widgets are fully interactive for all community members who can view the post. Members can take quizzes, use calculators, and interact with any Embeddy widget embedded in a post or space page.

Does embedding a widget affect Circle performance?

No. Iframes load independently and do not block the community page from rendering. Using loading="lazy" further defers widget loading until it scrolls into view.

Which Circle plans support embed blocks?

Embed blocks are available on all Circle paid plans. The custom HTML code injection feature may be restricted to higher-tier plans. Check your Circle plan for specific feature availability.

Ready to build your widget?

Create a free Embeddy widget — no code required. Get your embed code in minutes and share it with your Circle community.

Create your free widget at embeddy.ai