Back to blog
Add an Interactive Astrology Chart to Your Website

July 19, 2026

·

OpenEphemeris Team

Add an Interactive Astrology Chart to Your Website

Add an interactive natal chart, synastry bi-wheel, or Human Design bodygraph to any website. Two lines of HTML, no code skills, leads included.

embedwidgetastrologyhuman-designlead-generationapi

If you read charts for a living, your website has one job: turn a curious visitor into a conversation. Most practitioner sites fail at it quietly. A visitor lands, reads a paragraph about your approach, and leaves — because there was nothing there for them yet.

An embeddable astrology chart widget changes what your website is. Instead of describing what a reading feels like, your site casts one. A visitor enters their birth date, time, and place, and a full natal chart renders right on your page — computed at that moment against NASA JPL's DE440 ephemeris, the same planetary dataset used for deep-space mission planning. Not an image you uploaded. Not an approximation. Their sky, calculated.

The install is two lines of HTML. Everything else — chart types, house system, zodiac, colors, your logo, lead capture — is configured in a dashboard and applies to your live site instantly, without touching the code again.

What Your Visitors Get

Three chart types, in one widget, as tabs:

A natal chart — the full wheel: planets, houses, aspects, angles, rendered as crisp vector graphics that match your site's theme.

A synastry bi-wheel — two people's charts overlaid, for relationship-focused practices.

A Human Design bodygraph — type, authority, centers, gates, and channels, calculated from the exact moment the Sun sat 88° of solar arc behind its natal position. Most free HD tools approximate this. The widget solves it directly.

Your visitor picks a location from a built-in place search (no third-party maps, no API keys for you to manage), taps Generate, and the chart appears in about two seconds. On phones it scales cleanly — no pinching, no sideways scrolling.

The widget rendering a computed natal chart inside a practitioner's website.
The widget rendering a computed natal chart inside a practitioner's website.

Your Doctrine, Locked In

If you work in Whole Sign houses, a widget that silently renders Placidus is worse than no widget at all.

So the chart settings belong to you. House system, tropical or sidereal zodiac, which bodies appear — you set them once in the dashboard, and every chart the widget casts follows your system. You choose, per setting, whether visitors may adjust it. Lock everything, or let the astrology-curious explore house systems on their own — your call, enforced server-side, which means a visitor cannot override your doctrine even if they open the browser's developer tools.

Styling works the same way. Light, dark, or mono theme, your accent color, your logo in the widget — so it reads as part of your site, not a bolted-on iframe from somewhere else.

The Part That Pays For Itself: Leads

Charts are the gift. Leads are the business.

Flip on lead capture and the widget adds one honest step: before the full chart unlocks, the visitor is asked for their email — with a consent checkbox that cannot be hidden or pre-ticked. No consent, no lead. You can customize the headline, the button, and the consent wording to sound like you.

Every consented lead arrives with the birth details already attached — which means your first reply to a prospect can already say something true about their chart. That is a different opening move than "thanks for subscribing."

How a lead travels: chart, consent, then delivery to email, dashboard, webhook, and CSV.
How a lead travels: chart, consent, then delivery to email, dashboard, webhook, and CSV.

We built the pipeline as a pipe, not a CRM. Leads are emailed to you within the hour, appear in your dashboard immediately, export to CSV whenever you want, and can fire a webhook into Zapier, Make, or your own system. After 90 days we delete them from our side — they were always yours, and we don't keep what we don't need.

Installing It Without Being Technical

The snippet is two lines. The dashboard generates it with your widget ID already filled in, and the install guide walks through the exact clicks for WordPress, Squarespace, Wix, Webflow, and Showit — including the traps, like Wix's "Embed HTML" block, which sandboxes scripts and needs the site-wide Custom Code setting instead.

If you'd rather not touch your site at all, the dashboard has two escape hatches. One is a pre-written email you can send to whoever manages your website. The other is newer: a copy-paste instruction block for an AI coding agent — Claude Code, Cursor, Codex — that contains your snippet, the placement rules for your platform, and a verification step. Paste it to your agent, and it installs and checks the widget for you.

And because the configuration lives on our side, the snippet never changes. Rebrand from dark to light, add a chart type, change your house system — your site updates the moment you hit save in the dashboard.

What It Costs, Plainly

The widget is included on every paid OpenEphemeris plan — it's a feature, not a separate product. Removing the "Powered by OpenEphemeris" badge is included too: it's a toggle, not an upsell.

Here is the whole billing model. Each chart a visitor generates costs 2 credits, billed to your account, which is exactly what the same visualization costs if you request it from the API yourself. Loading the widget's configuration, the location autocomplete, and lead submissions are free, so a visitor typing "Melbourne" one letter at a time costs you nothing. If a render fails, the credits go back.

Those credits come out of the same monthly allowance as your direct API usage. There is no separate widget quota to track: one pot, resetting on your billing anniversary. Your embed key is locked to your website's domain, so nobody can point the snippet at another site and spend your allowance.

If you do reach the cap, the widget fails closed. Charts stop rendering and visitors see an error card until your allowance resets or you upgrade, which applies immediately. What you will never get is a surprise invoice: overage billing is off, so there is no way for a busy month to quietly bill you past your plan.

And you'll see it coming. We email you at 80%, 95%, and 100% of your allowance and show a banner in your dashboard. If you have a widget installed, the warning says so directly, because in your case running out isn't an API inconvenience, it's your public site going quiet.

Your visitors never need an account, and their birth data for a plain chart view is processed transiently — computed, rendered, and gone. Data is only stored when a visitor explicitly consents to leave their details for you.

Two Lines, Then It Compounds

A practitioner's website usually works like a brochure: it describes, and then it waits. A chart widget makes it work like a first session. Visitors arrive curious, leave with their actual chart, and the serious ones leave you their email on the way — attached to the exact birth data you need to open the conversation well.

The demo on our embed widgets page is the real widget, running live. Generate your own chart there, and if it feels like something your visitors would stay for, the dashboard will have yours configured in about five minutes.

Paste two lines. Get a calculation engine.

Configure your chart widget in the dashboard, paste the snippet into your site, and your visitors get real computed charts — while you get the leads. Included on every paid plan.