Skip to the main content
Wassiya

For scholarly review

Certification corpus

This page states every case the calculator computes, in plain words, with the shares that result. It exists so that someone who does not read code can check the work and say plainly where it is wrong. Nothing here has been certified. That is what is being asked for.

There are three parts: 40 cases the engine computes, a part that is currently empty because nothing is declined outright, and 6 questions that need a ruling before the corresponding feature is built. If a case below is wrong, naming its reference — the short code beside each heading — is enough for it to be corrected and locked so it cannot silently change again.

The cases below are the artifact under review and are written in English, which is the language they will be certified in. The explanation around them is in your language; the cases themselves are reproduced as written, so that a correction and the record it corrects cannot drift apart.
Related: the Method page states the rules in the abstract; this page is the worked cases. Corrections and questions to hello@wassiya.org.

Part one — computed cases

01A wife and one son

wife-son

Survivors A wife and one son.

Wife or wives1/8
Sons7/8
No correction

The wife's eighth where a descendant survives; the son takes the whole residue.

02A wife, a son and two daughters

wife-son-daughters

Survivors A wife, one son and two daughters.

Wife or wives1/8
Sons7/16
Daughters7/16
No correction

A son makes his sisters residuary with him, two shares to the male against one to the female. The two daughters hold 7/16 between them, 7/32 each.

03A husband and one daughter

husband-daughter

Survivors A husband and one daughter.

Husband1/4
Daughters3/4
Radd — surplus returned

The husband's quarter where a descendant survives; the surplus returns to the daughter alone, the spouse taking no part in the return.

04Al-Umariyyatan, with a husband

umariyya-husband

Survivors A husband, the father and the mother. No one else.

Husband1/2
Mother1/6
Father1/3
No correctionThe ruling of 'Umar, followed by all four schools.

The mother takes a third of the remainder after the spouse, not a third of the estate.

05Al-Umariyyatan, with a wife

umariyya-wife

Survivors A wife, the father and the mother. No one else.

Wife or wives1/4
Mother1/4
Father1/2
No correctionThe ruling of 'Umar, followed by all four schools.

The second of the two 'Umariyya cases.

06Al-Minbariyya

minbariyya

Survivors A wife, the mother, the father and two daughters.

Wife or wives1/9
Mother4/27
Daughters16/27
Father4/27
Awl — shares reduced'Ali, answering from the minbar: her eighth has become a ninth.

The fixed shares come to 27/24, more than the estate, so all are reduced proportionally. The wife's eighth becomes a ninth.

07Awl to thirteen

awl-13

Survivors A wife, the mother and two full sisters.

Wife or wives3/13
Mother2/13
Full sisters8/13
Awl — shares reduced

The shares total 13/12 and are reduced onto a base of thirteen.

08Both parents and a son

parents-son

Survivors The father, the mother and one son.

Mother1/6
Father1/6
Sons2/3
No correction

Each parent takes a sixth where a son survives; the son takes the residue.

09The father and a son

father-son

Survivors The father and one son.

Father1/6
Sons5/6
No correction

The father is held to his sixth by a male descendant.

10The father and one daughter

father-daughter

Survivors The father and one daughter.

Daughters1/2
Father1/2
No correction

Where the descendants are female only, the father takes his sixth as a fixed share and the residue besides — a sixth plus a third here.

11The father and two daughters

father-two-daughters

Survivors The father and two daughters.

Daughters2/3
Father1/3
No correction

Two or more daughters take two thirds between them; the father takes the rest.

12Return to the mother and daughter

radd-mother-daughter

Survivors The mother and one daughter.

Mother1/4
Daughters3/4
Radd — surplus returned

The fixed shares claim only two thirds and no residuary heir survives, so the surplus returns in proportion.

13Return excluding the spouse

radd-excluding-spouse

Survivors A husband, the mother and one daughter.

Husband1/4
Mother3/16
Daughters9/16
Radd — surplus returned

The husband keeps exactly his quarter. The surplus is returned only among the mother and daughter.

14Return with a wife present

radd-wife-daughters-mother

Survivors A wife, two daughters and the mother.

Wife or wives1/8
Daughters7/10
Mother7/40
Radd — surplus returned

The shares total 23/24. The remaining twenty-fourth returns to the daughters and mother in the ratio of their shares, the wife excluded from the return.

15Uterine siblings

uterine-siblings

Survivors A husband, the mother and two maternal siblings.

Husband1/2
Mother1/6
Maternal siblings1/3
No correction

Two or more uterine siblings take a third, divided equally without regard to sex. Their presence also reduces the mother to a sixth. The shares happen to total exactly one.

16Siblings reduce the mother without inheriting

siblings-reduce-mother

Survivors The father, the mother and two full brothers.

Mother1/6
Father5/6
No correction

The father excludes the brothers entirely, yet they still cut the mother from a third to a sixth. Exclusion from inheriting does not undo the reduction.

17A son's daughter completes the two thirds

sons-daughter-completes

Survivors The father, one daughter and one son's daughter.

Daughters1/2
Son's daughters1/6
Father1/3
No correction

Behind a single daughter, the son's daughter takes a sixth, completing the two thirds due to the female descendants.

18A son excludes a predeceased son's children

son-blocks-grandchildren

Survivors Two sons, and one son of a son who died first.

Sons1
No correction

The orphaned grandchild is excluded. Provision for him is made from the wasiyyah, not from the fixed shares.

19A full sister alongside a daughter

sister-with-daughter

Survivors One daughter and one full sister.

Daughters1/2
Full sisters1/2
No correction

The sister does not take her fixed half; she becomes residuary alongside the daughter (asaba ma'a al-ghayr).

20Full brothers and sisters with the mother

brothers-and-sisters

Survivors The mother, two full brothers and one full sister.

Mother1/6
Full brothers2/3
Full sisters1/6
No correction

The siblings take the residue two to one. The mother is at a sixth because two or more siblings survive.

21Four wives sharing one eighth

four-wives

Survivors Four wives and one son.

Wife or wives1/8
Sons7/8
No correction

The wives' share does not multiply with their number. Four wives divide the single eighth equally, a thirty-second each.

22A grandmother standing in for the mother

grandmother-alone

Survivors The paternal grandmother and one son. Neither parent survives.

Grandmothers1/6
Sons5/6
No correction

A grandmother takes the sixth in place of the mother where no mother survives.

23The father excludes his own mother

grandmother-excluded-by-father

Survivors The father, the paternal grandmother and one son.

Father1/6
Sons5/6
No correction

The majority position, held by three schools: the father excludes the grandmother through him. The Hanbalis have her inherit alongside him, which is the one point at which this case differs by school.

24The grandfather shares with a brother

grandfather-muqasama

Survivors The paternal grandfather and one full brother.

Paternal grandfather1/2
Full brothers1/2
No correctionThe doctrine of Zayd b. Thabit, followed by Malik, al-Shafi’i and Ahmad.

Sharing as though he were a brother gives the grandfather a half, which is more than a third of the estate, so that is what he takes. On the Hanafi position he would exclude the brother and take everything.

25The grandfather takes a third rather than share

grandfather-third

Survivors The paternal grandfather and two full brothers.

Paternal grandfather1/3
Full brothers2/3
No correction

With two brothers, sharing would give him only a third, and a third is also his floor — the two coincide. With three or more brothers the third is plainly the better of the two.

26The grandfather falls back to his sixth

grandfather-sixth

Survivors A husband, the paternal grandfather and two full brothers.

Husband1/2
Paternal grandfather1/6
Full brothers1/3
No correction

The husband takes half, leaving half. A third of that remainder is a sixth of the estate, which is also the least the grandfather may take, so he takes a sixth and the brothers divide the rest.

27Al-Akdariyya

akdariyya

Survivors A husband, the mother, the paternal grandfather and one full sister.

Husband1/3
Mother2/9
Paternal grandfather8/27
Full sisters4/27
Awl — shares reducedNamed for the confusion it caused; the ruling is Zayd’s.

The sister is given her half, the shares are reduced onto nine, and then the grandfather and sister pool what they hold and divide it two to one. On the Hanafi position the grandfather would exclude her entirely.

28A consanguine sister completes the two thirds

consanguine-completing

Survivors A husband, one full sister and one consanguine sister.

Husband3/7
Full sisters3/7
Half-sisters by the father1/7
Awl — shares reduced

Behind a single full sister the consanguine sister takes a sixth, completing the two thirds due to sisters. The shares then come to seven sixths and are reduced onto seven.

29Consanguine sisters with no full sister

consanguine-alone

Survivors The mother and two consanguine sisters.

Mother1/5
Half-sisters by the father4/5
Radd — surplus returned

With no full sister surviving, the consanguine sisters stand in their place and take the two thirds. The surplus then returns, no residuary heir surviving.

30A husband, and nobody else at all

spouse-alone

Survivors A husband. No descendant, parent, sibling or more distant relative survives.

Husband1
Radd — surplus returnedAl-Mawardi on necessity calling for radd and dhawu al-arham where there is no bayt al-mal; al-Dasuqi reporting the Maliki qualification.

The husband takes a half as his fixed share. A spouse is the standard example of an heir who takes no part in the return, so classically the remaining half would pass to the bayt al-mal. Where no properly administered treasury exists the later authorities return it rather than let it escheat, and the calculator reports the classical answer alongside.

31A distant relative, and no one nearer

distant-kindred-sole

Survivors A daughter’s son. No spouse, descendant, parent or sibling survives.

Distant relatives1
No correction

The schools split evenly on whether distant kindred inherit at all, so there is no majority to take. The tie is broken on the ground that the classical alternative — the public treasury — does not exist here, and following it would mean the estate escheating to a state rather than reaching a surviving relative.

32A distant relative alongside a husband

distant-kindred-with-spouse

Survivors A husband and a daughter’s son.

Husband1/2
Distant relatives1/2
No correction

The spouse takes the fixed half. A spouse does not exclude distant kindred, so the remainder goes to the relative rather than returning to the spouse.

33A nearer heir excludes the distant relative

distant-kindred-excluded

Survivors The mother and a daughter’s son.

Mother1
Radd — surplus returned

Distant kindred inherit only where no nearer heir survives. The mother takes her third and the surplus returns to her, rather than passing further out.

34Al-Mushtaraka

mushtaraka

Survivors A husband, the mother, two maternal siblings and two full brothers.

Husband1/2
Mother1/6
Maternal siblings1/3
No correctionNamed for the sharing; also called al-Himariyya, for the brothers’ plea that their father might as well have been a donkey.

The fixed shares exhaust the estate, so the full brothers, who are residuary, take nothing. That is the Hanafi and Hanbali answer and the one shown by default. 'Umar ruled that they share the uterine third head for head, since whatever their fathers they have the same mother, and Malik and al-Shafi'i follow him — under those schools the third divides four ways and each group takes a sixth.

35A residuary full sister excludes the consanguine sister

consanguine-excluded-by-residuary-sister

Survivors One daughter, one full sister and one consanguine sister.

Daughters1/2
Full sisters1/2
No correction

The daughter takes a half and the full sister takes the residue alongside her. Standing in a brother’s place, the full sister excludes the consanguine sister entirely — the sixth that completes the two thirds is available only where the full sister takes a fixed share, not where she has been made residuary.

36Al-mu'adda: the consanguine brother is counted, then takes nothing

muadda-brothers

Survivors The paternal grandfather, one full brother and one consanguine brother.

Paternal grandfather1/3
Full brothers2/3
No correctionAl-Rahbiyya: wa-hsib bani al-abi lada al-a'dad. Ibn Qudama, al-Mughni; al-Shirbini, Mughni al-Muhtaj.

The consanguine brother is counted in against the grandfather even though the full brother excludes him from inheriting, so the grandfather shares against three heads rather than two and takes a third rather than a half. The full brother then takes back what the consanguine brother was counted for. Without the counting the grandfather would take half.

37Al-mu'adda: a lone full sister cannot take beyond her half

muadda-sister-cap

Survivors The paternal grandfather, one full sister and one consanguine brother.

Paternal grandfather2/5
Full sisters1/2
Half-brothers by the father1/10
No correction

The consanguine brother is counted in, giving the grandfather two fifths. The full sister then takes back what he was counted for, but only up to the half due to a sole sister; the tenth left over falls to the consanguine brother, who therefore does inherit here.

38Two sisters are not al-Akdariyya

akdariyya-two-sisters

Survivors A husband, the mother, the paternal grandfather and two full sisters.

Husband1/2
Mother1/6
Paternal grandfather1/6
Full sisters1/6
No correctionSibt al-Maridini, Sharh al-Rahbiyya, on the conditions of al-Akdariyya.

Al-Akdariyya is defined for one sister and no other sibling. With two, the ordinary rules apply: the sisters reduce the mother to a sixth, the grandfather falls back to his sixth, and the base is six with no reduction at all.

39Al-Akdariyya with a consanguine sister

akdariyya-consanguine

Survivors A husband, the mother, the paternal grandfather and one consanguine sister.

Husband1/3
Mother2/9
Paternal grandfather8/27
Half-sisters by the father4/27
Awl — shares reducedIbn Qudama, al-Mughni; al-Mawardi, al-Hawi al-Kabir.

The case is defined for a sister full or consanguine, and she takes exactly what a full sister would. Without this she would be given nothing at all, the grandfather's sixth having exhausted what was left.

40Excluded brothers still reduce the mother

umariyya-broken-by-siblings

Survivors A wife, the father, the mother and two full brothers.

Wife or wives1/4
Mother1/6
Father7/12
No correction

The father excludes the brothers, but two or more siblings cut the mother to a sixth whether or not they inherit, so she never reaches the third that the 'Umariyya rule adjusts. This is not one of al-Umariyyatan. With a husband the two routes agree at a sixth by coincidence; with a wife they do not, and the difference is a quarter against a sixth.

Part two — cases it refuses

Nothing is currently declined. Every configuration the model can represent produces an answer — which is a statement about coverage, not about correctness, since none of those answers has been certified. Where an answer rests on there being no bayt al-mal, the classical rule it departs from is stated alongside it.

Part three — open questions

These are not arithmetic. They are decisions about what the service should do, and each one is currently either unbuilt or built on an assumption that needs confirming.

Q01May the surplus be returned to the fixed-share heirs for a Maliki or Shafi'i user in the United States?

Both schools classically direct a surplus to the bayt al-mal rather than returning it. There is no such treasury here, and contemporary practice in both schools appears to permit the return.

Currently The engine returns the surplus for all four schools, and shows the Maliki and Shafi'i user a note explaining why.

Q02Is it permissible to accept payment from a charity in exchange for featuring it among the options at the moment a user allocates the wasiyyah?

This is the intended means of funding the service. The user would remain free to name any organisation, ordering would never be affected by payment, and the arrangement would be disclosed on the screen itself.

Currently Not yet built. Awaiting this ruling before the screen is designed.

Q03How should the service present provision for close non-Muslim relatives — a convert's parents, for instance?

The majority classical position is that inheritance does not pass between Muslim and non-Muslim, and the wasiyyah is the usual accommodation. This is an emotionally difficult screen and the wording matters.

Currently Not yet built.

Q04How should provision for an adopted child be framed?

United States law treats an adopted child as a legal child with full inheritance rights; classical fiqh does not create an inheritance relationship through adoption. Provision through the wasiyyah is the usual accommodation.

Currently Not yet built.

Q05Should the service actively recommend using part of the wasiyyah for the children of a predeceased son?

They are excluded by a surviving son in all four schools. Reform statutes in Egypt, Syria and Pakistan address this by obligatory bequest. Families frequently find the exclusion shocking.

Currently The engine excludes them and emits a note pointing to the wasiyyah. It does not yet recommend an amount.

Q06Should Ja'fari inheritance rules be supported at all?

They differ structurally from the Sunni schools, including in the rejection of awl. Supporting them means a separate engine path and a second review.

Currently Not supported. The interface does not currently say so, which should be fixed either way.

Every case on this page is checked against the calculator automatically. If the calculator changes and a case here does not, the discrepancy is caught before it can reach anyone. Once a case is certified, it is locked: altering it afterwards is treated as a change requiring the same approval as the original.