Writing good rules
A policy is a list of rules written in plain language. AD80 reads each rule as you wrote it and scores every ad against every rule. Good rules are short, concrete and about one thing.
The basics
Section titled “The basics”- Write what you do not allow. Phrase each rule as a prohibition about the ad, for example “No ads showing alcoholic drinks.” The question AD80 answers per rule is “does this ad break this rule?”.
- One idea per rule. “No alcohol” and “No gambling” are two rules, not one. Separate rules give you separate scores, separate filters in the inbox and clearer explanations.
- Describe what can be seen. AD80 judges the ad image: the pictures, the text written in it, logos and symbols. Name things that are visible (“a bottle of beer”, “a casino chip”, “the word bet”) rather than intentions or facts that an image cannot show.
- Be specific where it matters. “No ads for alcohol” is clear. “No inappropriate ads” is not: AD80 cannot know what you find inappropriate. Say what you mean.
- Say what is still allowed when the line is fine. If you only object to part of a category, say so, for example “No ads for interest-based loans or credit cards; Islamic (sharia-compliant) finance is allowed.”
- English or Arabic. Write each rule in the language you think in. You can mix languages in one policy. The dashboard detects Arabic for you.
Rule fields
Section titled “Rule fields”| Field | Limits | Notes |
|---|---|---|
| Rule id | Letters, digits, dot, dash or underscore, 1 to 64 characters, unique in the policy | Used in the API, filters and webhooks, for example no-alcohol. Keep it stable. |
| Name | Up to 60 characters, optional | A short display name for lists and filters. |
| Language | en or ar, optional | The language you wrote the rule in. |
| Rule (text) | 1 to 500 characters | The rule itself. |
A policy needs at least 1 rule and can have up to 20. The dashboard checks these limits before you save; the server
checks them again. The structural limits that apply to your organization are also returned by
GET /v1/plan as policyLimits.
Good and weak rules
Section titled “Good and weak rules”| Weak | Better | Why |
|---|---|---|
| No bad ads. | No ads showing alcoholic drinks, bars or alcohol brands. | Says what to look for. |
| No alcohol or gambling or dating. | Three rules: alcohol; gambling; dating. | One idea per rule. |
| No ads that are haram. | Separate rules for alcohol, gambling, interest-based finance, revealing clothing… | AD80 judges what you describe, not a whole religious ruling. |
| No ads from competitor X. | No ads that show the name or logo of X. | An image shows a logo, not a business relationship. |
| Don’t show ads to children. | (Not a rule about the ad itself.) | AD80 judges the creative, not who saw it. |
Test before you rely on a rule
Section titled “Test before you rely on a rule”Use the Policy Playground to try your wording on real screenshots and samples. If an ad is flagged that you consider fine, or the other way round, adjust the rule and re-test. On the Violations page, mark mistakes as False positive: this feedback is kept and is used to check how well the scoring works.
See Rule examples for ready-made rules in English and Arabic, and Policy versions and re-scoring for what happens when you save.