If you run an astrology, wellness or lifestyle site on WordPress, you may want readers to be able to calculate a birth chart without sending them away first, and without signing up for an astrology API, paying for a plugin or writing code.
Lunara's free birth chart widget is one way to do that. It's a small form you embed on your own page. This guide explains exactly what it does, what it doesn't, and how to add it.
What your readers get
The widget is an entry form, not a chart.
- On your page, the reader enters their birth date and chooses their birth city from a list. The birth time is optional.
- When they choose to see their chart, Lunara opens in a new tab and shows its existing free results there. Nothing is calculated or displayed inside your page.
- On Lunara's results page, a paid automated reading is offered. It's optional; the free chart is the free chart either way.
It is not a chart wheel rendered on your site, a white-label tool, an email opt-in, an astrology API, an affiliate programme or a link exchange. There's no account, key, partner ID or Lunara subscription involved.
If the reader doesn't know their birth time
They don't need to invent one. The form's own hint under the time field says: "24-hour clock, from your birth certificate if you can. No time? You still get your Sun, Moon and planets."
If the time is left blank, no time is sent, and the results page shows the chart without a rising sign or houses rather than guessing them. The form also reminds readers: "Add birth time and city to unlock Rising and houses."
Before you add it: where the details go
Your readers should know this, and so should you.
- The date, time (if entered), city name and the city's coordinates are placed in the web address of the Lunara page that opens. That means they can appear in the reader's browser history.
- The widget doesn't ask for a name or an email address.
- When the reader searches for a city, the search text goes to Lunara's server, which looks it up with the GeoNames place-search service. Loading the form is also an ordinary request to Lunara's server, which keeps normal request logs.
The form itself tells readers: "Choosing to see your results opens Lunara in a new tab. Your birth details go into that page’s web address, so they appear in your browser history."
How to add it
- Open Lunara's free birth chart widget page and copy the embed code there. That page keeps the current version, so copy it from there rather than from anywhere else.
- In the WordPress block editor, add a Custom HTML block where you want the form.
- Paste the code into the block and save or update the page.
- Preview the page and check that the form appears.
To remove the widget later, delete the block.
WordPress.com and self-hosted WordPress are different
Whether the form appears depends on your WordPress setup, not on the code.
WordPress.com. WordPress.com's own Custom HTML block guide says that interactive embeds and iframes like this one "require a paid plan with hosting features activated". If your plan doesn't include that, the widget won't work there. You don't need to change plans to link to a free chart; see the fallback below.
Self-hosted WordPress (WordPress.org software). The WordPress.org documentation for the Custom HTML block explains that users without the unfiltered_html capability can have disallowed tags stripped on save, such as <script> and <iframe>. In practice, whether the iframe survives depends on your user role and on how your site or host is configured. Editors and authors may see it removed even when an administrator would not.
We can't promise the widget works on every host or plan, and we haven't tested every setup.
If the iframe won't stay: use a plain link
If the code disappears when you save, or your plan doesn't allow iframes, don't try to work around the filter. Add an ordinary text link or button to the free calculator instead:
https://lunaraastro.com/free-natal-chart-calculator
Readers get the same free form, on Lunara rather than on your page. Nothing else changes.
An example introduction you can adapt
Example only. Edit it to suit your site.
Calculate your birth chart. Enter your birth date and city below, plus your birth time if you know it. Your chart opens on Lunara, a separate site, in a new tab. Your details go into that page's address, so they'll appear in your browser history. Don't know your time? Leave it blank; you'll still see your Sun, Moon and planets.
Troubleshooting
The block is empty or the code vanished after saving. Your role, plan or host is filtering iframes. Ask your site administrator, or use the plain link above.
The reader submits but nothing seems to open. A browser or privacy setting can stop a new tab from opening. After a submit, the form shows its own message: "Your chart opens on Lunara in a new tab. If it didn’t open, Open your chart on Lunara." That second part is a link to the same chart, which the reader can tap.
The form looks cramped. The embed code sets a fixed height. Place it in a full-width content area rather than a narrow sidebar.
Quick facts
- Free: no plugin, API key, account or payment.
- An entry form on your page; results open on Lunara in a new tab.
- Birth details travel in the results address; no name or email is collected.
- Works only where your WordPress setup allows iframes; otherwise use a plain link.
Text written with AI assistance. Lunara makes the widget and the readings mentioned here.