How the ShadiSunnah Compatibility Algorithm Works and Why It Is Different

When you search for a potential spouse on ShadiSunnah, you will notice a compatibility percentage next to each profile. This is not a random number and it is not based on an opaque algorithm that nobody can explain. We built it with specific Islamic values in mind and we think you deserve to understand how it works.

What Most Matrimonial Platforms Get Wrong

Many matrimonial platforms show you profiles ranked by how recently they were created or how complete they are. A few use simple filters that match on one or two criteria. Almost none of them use a proper compatibility model that weighs different factors based on how much each one actually matters to long-term compatibility.

We looked at what Islamic scholarship says about the qualities that matter in a spouse. We looked at what research on lasting marriages actually shows. And we built a scoring system that reflects both.

The Factors We Consider

Our compatibility score is calculated across nine different dimensions.

Religion and sect are at the top of the list because this is where the Prophet himself placed the emphasis. A match between two people who share the same religious values, the same understanding of their faith, and the same approach to Islamic practice is more likely to find that tranquility that Allah describes in Surah Ar-Rum. We weight this dimension most heavily in the algorithm for exactly this reason.

Country and location matter for practical reasons. A marriage between two people living on opposite sides of the world introduces genuine logistical challenges that should be considered seriously, not ignored in favour of idealism.

Marital status is considered because the preferences and experiences of someone who has never been married are genuinely different from those of someone who is divorced or widowed. A good match takes this into account.

Caste is included as a factor because it remains a genuine consideration for many families, particularly of South Asian heritage. However, we deliberately weight it lower than character-based factors because Islam itself places very little weight on lineage compared to righteousness.

Profession, education level, and income range are included because a reasonable compatibility in life circumstances and ambitions makes for a more stable foundation. We do not place excessive weight on these but they are not ignored.

Age compatibility is calculated based on the closeness of the ages of the two people, with a natural and gentle tolerance rather than a hard cutoff.

Shared hobbies and interests add to compatibility when they overlap, though we weight them modestly because shared values matter far more than shared pastimes.

Languages spoken contribute to practical daily compatibility, particularly in diaspora communities where language barriers between families can be a real source of friction.

What the Score Means

A score of 90 percent or above indicates a very strong alignment across most of the factors we consider. It does not mean the two people are definitely right for each other. It means that on the dimensions we can measure, they are highly compatible.

A score of 70 to 89 indicates a solid match with perhaps one or two areas where expectations or backgrounds differ. These are still strong candidates worth exploring.

A score below 70 does not mean incompatible. It may mean the families come from different countries, or practice slightly differently, or have different educational backgrounds. Whether those differences matter depends on the individuals.

What the Score Cannot Tell You

The algorithm cannot measure character. It cannot tell you how someone treats their family when they are tired and stressed. It cannot tell you how honest they are. It cannot tell you whether they will be a patient parent or a supportive spouse. These things can only be discovered through proper meetings and conversations.

Think of the compatibility score as a starting point, a way to identify profiles that are worth exploring rather than a final judgment on whether a match will work. The human conversations that follow are where the real assessment happens.

Why We Built It This Way

We built this platform because we believe the Muslim marriage process deserves a tool that takes Islamic values seriously. Not a tool that copies what secular dating apps do and adds a halal label. A tool that genuinely reflects what the Prophet taught about choosing a spouse and what a Muslim family actually needs.

The algorithm is one expression of that. It will continue to improve as we learn more about what makes the most difference to the families using ShadiSunnah. We take that responsibility seriously.