Embeddable widget
Add Islamic Source Search to Your Website
The Madeenan widget lets visitors search Quran, Hadith, Tafsir, and dua sources from an iframe. It returns source cards only. It does not generate religious answers.
Configure the Embed
Live Preview
View Embed HTML
<iframe
src="https://madeenan.com/widget?mode=search&theme=light&indexes=quran%2Chadith%2Ctafsir%2Cdua"
title="Madeenan Islamic source search"
width="100%"
height="640"
loading="lazy"
style="border:0;max-width:100%;"
></iframe>
<p><a href="https://madeenan.com/embed?utm_source=embed&utm_medium=partner&utm_campaign=source-widget">Powered by Madeenan source retrieval</a></p>What the Widget Does
- Retrieves live source cards or displays a fixed source ID.
- Shows Arabic text, translation, references, and grades where available.
- Includes clear Madeenan attribution.
- Works without model-provider keys or generated answers.
What It Does Not Do
- It does not issue fatwas or replace qualified scholarship.
- It does not generate explanations, summaries, or chat replies.
- It does not expose arbitrary saved query text as a public source bundle.
URL Parameters
Configure the iframe by changing query parameters on the widget URL.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| mode | search | source | bundle | No | search | Choose live search, one fixed source card, or a fixed source bundle. |
| theme | light | dark | No | light | Choose the widget color mode. Use dark when the surrounding page is dark. |
| placeholder | string | No | Search Quran, Hadith, Tafsir, and duas… | Customize the input prompt for your audience. Keep it short enough for mobile. |
| indexes | csv | No | quran,hadith,tafsir,dua | Limit the sources searched. Supported values are quran, hadith, tafsir, and dua. Invalid values are ignored. |
| q | string | No | — | Optional starting query. Useful when embedding a widget near an article about a specific verse, hadith, or dua. |
| source | fixed source ID | No | — | Select a fixed source when mode is source. Unknown IDs render a safe unavailable state. |
| topic | topic slug | No | — | Select a topic source bundle when mode is bundle. The embed never shows a generated answer. |
When You Need More Than Embedded Search
Teams building product workflows can use the API directly for custom search interfaces, citation rendering, and source-backed AI answers with their own model provider.