madeenan

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.

Iframe Snippet

Paste this into a page, article, school portal, or masjid website where a small source search surface would help readers explore further.

<iframe
src="https://madeenan.com/widget?theme=light"
title="Madeenan Islamic source search"
width="100%"
height="640"
loading="lazy"
style="border:0;max-width:100%;"
></iframe>

What It Does

  • Retrieves source cards from Madeenan search.
  • Shows Arabic text, translation, references, and grades where available.
  • Includes Madeenan attribution at the bottom of the widget.
  • Works without model provider keys or AI answer generation.

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 add tracking scripts inside the iframe.

URL Parameters

Configure the iframe by changing query parameters on the widget URL.

FieldTypeRequiredDefaultNotes
themelight | darkNolightChoose the widget color mode. Use dark when the surrounding page is dark.
placeholderstringNoSearch Quran, Hadith, Tafsir, and duas…Customize the input prompt for your audience. Keep it short enough for mobile.
indexescsvNoquran,hadith,tafsir,duaLimit the sources searched. Supported values are quran, hadith, tafsir, and dua. Invalid values are ignored.
qstringNoOptional starting query. Useful when embedding a widget near an article about a specific verse, hadith, or dua.

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.