Assistance

Find a passage from its wording or describe the idea you are looking for.

1. Search by wording

   Enter Arabic words from the passage, then press Search. For a standard search, use the add-phrase button to combine phrases: “and” requires both phrases, while “or” accepts either. Complete or remove empty phrases before submitting.

2. Search by meaning

   Enable By meaning and write a clear topic or question in your own language, for example “kindness to parents”. Latin-script input automatically enables this mode. The ? beside the checkbox explains semantic search. Related results can use different wording; read their original text and source to assess their relevance.

3. Choose books and text types

   Open Search Options to select books and element types. Use Only to start with one book, then add others. New searches select Hadith and Semantic groups by default. Keep at least one book and type selected. Match diacritical marks refines wording searches; Discovery helps with typos and word prefixes.

4. Read and explore results

   Expand a result to read its full text. Use Copy or Share to reuse it, Open in book to read its surrounding context, or Similar to find related passages. A semantic-group result opens its theme for further exploration. The result’s source and reference help you locate the original passage.

5. Keep or share a search

   Use Save to keep the current search and its options. Open Saved and recent searches to run a previous search or manage saved entries, including renaming and deleting them. Share creates a link to the search settings so another person can open the same search. Saved searches and recent history are kept in this browser.

Explore groups of related hadiths, from broad themes to more specific subjects.

1. Choose a view and a theme

   Switch between Nodal view for a visual map and List view for a tree. Open a group to explore its children. Use the breadcrumb path to return to a broader theme. A leaf group opens the hadith reader because it has no further child groups.

2. Narrow the exploration

   Choose the books to include and filter the current and next semantic levels by title. Outside the Arabic interface, Translate displays available group titles in your interface language. Some titles may remain in Arabic when no translation is available.

3. Search across all groups

   Open Search clusters to search beyond the current level. Refine by collection, semantic level, branch or leaf type, and hadith count; you can also include outliers and change the sort order. Open a result to continue exploring that group.

4. Read and share a group

   In a leaf group, read its hadiths and use the available passage actions to open their source or explore similar hadiths. Share links to the selected group and preserves the chosen view, title-translation option and book filters.

Read the available collections and place a passage in context.

1. Open a collection

   Select a book from Books to open its reader. The details control shows available information about the author, edition and review status. If offered, Continue returns you to your last saved reading position in that book.

2. Move through the book

   Scroll to read the surrounding text. Use Go to… to reach a hadith number or a heading, and the Kitab, Bab and Section controls to navigate the available structure. Search in book opens a search scoped to that collection.

3. Act on a passage

   Open a hadith’s actions to search for similar passages, send it to Sanad or add a bookmark. Selecting text reveals Search this so you can search the selected wording. When sending to Sanad, choose an existing view or create a new one.

4. Return with bookmarks

   Open Go to bookmarks to find a saved passage. Search bookmarks, select one to preview it, then open it in the reader. You can rename or delete bookmarks. Bookmarks and reading positions are stored in this browser; use the same browser to find them again.

Build an interactive view of transmission chains and compare narrations.

1. Insert your first hadith

   Choose Insert Hadith, select a collection, and optionally narrow by Kitab, Bab or Section. Enter a hadith number or browse the available hadiths, then insert one. You can also send a hadith from the book reader to a Sanad view.

2. Explore the graph

   Pan and zoom to follow the chains; Fit graph brings the whole view into frame. Double-click a narrator’s name to consult available information, or a matn to read the full hadith. Insert more hadiths into the same view to compare their chains.

3. Organize your study

   Use the view tabs to create, rename or close separate studies. The source list lets you focus on or remove a hadith. Open View options from Graph actions to adjust the display and grouping of the graph.

4. Export and report

   Use Share for an image, or Export to choose PNG or PDF and capture the full graph or current viewport. Chain representations can contain errors: compare them with the source and use Report an error when you notice an incorrect representation.

Learn how to help keep Hujja available and support its development.

1. Contribute or share

   Read the Support us page to understand the project’s running costs. Support Hujja opens the Ko-fi contribution interface. You can also share the support page through its WhatsApp, Telegram or X links.

2. Ask about support

   Use Contact us on the support page if you need information, or open About / Contact from the navigation menu.

Adapt the interface and reading display to your needs.

1. Choose language and appearance

   Select Arabic, English, French or Urdu. Language and reading direction change immediately on this device. Choose a Light, Dark or System theme; System follows your device’s appearance preference.

2. Adjust reading comfort

   Choose the Arabic font and font size, a text-color preset, and Latin, Arabic or Urdu digits. These settings help you read the interface and hadith content comfortably.

3. Control result previews

   Set the number of visible lines or choose Full hadith. You can shorten intermediate narrator pairs and show only the first matn block in collapsed results. Expand a result to see the full available text.

4. Manage search history

   Turn automatic recent-search saving on or off. Clear search history removes recent searches from this browser after confirmation; include saved searches only if you also want to remove them. Browser preferences and saved items may be lost when you clear site data or use private browsing.

Understand the project, contact us and consult the privacy policy.

1. Read About

   The About tab explains Hujja’s semantic approach and links to its research tools. Semantic similarity helps you discover texts; it does not itself establish authenticity or a legal ruling.

2. Send a message

   Open the Contact tab, choose a subject, enter your email address and write your message. Accept the required email-storage consent, then send. Wait for the success message before considering your enquiry delivered.

3. Review privacy or report a passage

   Open the Privacy policy tab to learn how data is handled. If an individual passage or chain is incorrect, use its Report an error action when available and describe the correction. Accept the report’s required consent before submitting.

1. No matching results

   Try a shorter phrase, broaden the selected books or types, and check diacritic matching. For an idea expressed in different words, try By meaning. For a spelling variation, try Discovery. Semantic groups can help you approach the subject from a related theme.

2. Loading fails

   Check your connection and use Try loading again when offered. If the problem persists, contact us with the page link, the action you tried and any visible error message so we can reproduce it.

3. Saved items are missing

   Check that you are using the browser and device where you saved them. Saved searches, bookmarks and preferences use local browser storage; another browser, private browsing or cleared site data can make them unavailable.