How to Embed a Secure Vote on Your Website in Under 5 Minutes

Why Embed a Vote?

Not every vote needs its own landing page. Sometimes you want voting to happen where your audience already is:

• HOA websites: Let homeowners vote directly from the community portal
• Nonprofit sites: Board elections embedded in the member dashboard
• Creator communities: Fan polls embedded in your content
• Company intranets: Team decisions without switching apps
• Event pages: Live audience polls during conferences

vote.direct embeds are fully functional voting interfaces, not simplified poll widgets. They support all verification levels(email, SMS, government ID), real - time results, weighted voting, and complete audit trails.

How It Works

Step 1: Create Your Vote

Go tovote.direct / create and set up your election the normal way. Choose your questions, verification level, schedule, and settings.

Step 2: Get the Embed Code

Once your vote is published, copy the embed URL from your dashboard. The format is:

```

https://vote.direct/embed/v/your-vote-slug

```

Step 3: Add to Your Site

HTML (any website):

```html

<iframe

src="https://vote.direct/embed/v/your-vote-slug"

width="100%"

height="600"

frameborder="0"

allow="clipboard-write"

style="border: none; border-radius: 8px;"

></iframe>

```

WordPress:

Use the Custom HTML block in Gutenberg and paste the iframe code above.

Squarespace:

Add a Code block and paste the iframe. Set to "Display Source" if HTML doesn't render.

React / Next.js:

```jsx

export function VoteEmbed({ slug }) {

return (

<iframe

src={`https://vote.direct/embed/v/${slug}`}

width="100%"

height="600"

style={{ border: 'none', borderRadius: '8px' }}

allow="clipboard-write"

/>

);

}

```

That's it. The embed handles everything: voter verification, ballot display, vote submission, and results.

What's Included in the Embed

The embed is a fully responsive web application, not a simplified widget. It adapts to the container width and works on all devices.

Embed vs. Share Link vs. API

Real-World Examples

HOA Community Portal

A 500-unit community embeds their annual board election directly on their HOA website. Homeowners log into the community portal and vote without navigating to a separate site. Participation jumped from 35% to 62% in the first year: members were more likely to vote when it was one click away on a site they already visit.

Conference Live Polls

A tech conference embeds live audience polls on their event page. Speakers pose questions during talks, and attendees vote from their phones by visiting the event page. Results update in real time on the main screen.

Creator Community

A YouTube creator with 500K subscribers embeds fan polls on their website. "Which game should I play next?" gets 15,000 votes with email verification, real fans, not bots.

Security Considerations

Embeds use the same security infrastructure as standalone votes:

• HTTPS only: Embeds are served over TLS 1.3
• CORS headers: The embed communicates with vote.direct APIs using standard CORS
• No cookie leakage: The iframe is sandboxed; your site cannot access voting session data
• CSP compatible: Works with Content Security Policy headers (add `vote.direct` to your frame-src directive)

The voter's identity verification and vote submission happen entirely within the vote.direct iframe. Your website never handles or sees voter PII.

FAQ

Q: Does the embed work on mobile?

Yes. The embed is fully responsive and works on phones, tablets, and desktops. It adapts to the iframe container width automatically.

Q: Can I style the embed to match my site?

The embed uses vote.direct's design system, but it inherits your container's width and border radius. Custom theming (colors, fonts) is on our roadmap.

Q: What happens when the vote closes?

The embed automatically switches from the ballot view to the results view. No code changes needed.

Q: Do voters need a vote.direct account?

No. Voters verify their identity (email, SMS, or ID) directly in the embed. No account creation required.