Ship your app
App review & publishing
What a version needs before you submit it, what the LARM team reviews, and the stages an app goes through before it reaches merchants.
Version details
| Field | Rule |
|---|---|
| Name in Arabic and English | 2 to 160 characters |
| Description in Arabic and English | 10 to 2000 characters |
| Short description | 10 to 240 characters, shown on the app store card |
| Category | Reports & analytics, Catalog management, Physical inventory, Content tools, Messaging & marketing |
| Version number | semver, such as 1.2.0 |
| Scopes | Required and optional, with a justification of 10 to 500 characters for each |
| Redirect URLs | 1 to 5 |
| Webhook URL | At most one |
| Launch URL, uninstall & privacy webhook URL, support URL and privacy policy URL | Required |
| Testing instructions | 10 to 2000 characters: how the reviewer can try your app |
All URLs must be https, with no username, # or *, and at most 2048 characters.
Images
| Image | Size | Format and file size |
|---|---|---|
| Logo | Exactly 512 × 512 | PNG or WebP, up to 256 KB, single frame |
| Cover | 2.2:1 aspect ratio, from 440 × 200 to 4400 × 2000 | PNG or JPEG, up to 512 KB |
| Screenshots | Up to 6, 320 to 4000 pixels | PNG or JPEG, up to 512 KB each, with alt text |
For the cover, 1320 × 600 works well.
Stages
| Version | Meaning |
|---|---|
draft | A draft you can edit |
submitted | Submitted and waiting for review |
in_review | Under review |
changes_requested | Changes are required; the notes are in the review requests |
approved | Approved |
published | Published to merchants |
retired | Replaced by a newer version |
App review takes up to 5 business days (Sunday to Thursday).
What app review checks
- The scopes match the app's function, and the justification for each scope is clear. Customer data and digital content scopes are reviewed more closely.
- Install, authorization and launch work on a development store following your instructions.
- The webhook endpoint verifies signatures and responds quickly.
- The uninstall & privacy webhook URL receives data-deletion requests and acknowledges them.
- The privacy policy and support page are available and are specific to your app.
After publishing
- Any change to scopes or URLs requires a new version and a new review.
- Merchants on the previous version stay on it until they approve the new version's scopes, if the scopes changed.
- Paid apps are not available yet. Your app must be free for merchants on LARM.