Saudi Riyal Symbol | New SAR Sign for Backend, Website, POS & Reports
by TechNion Digital Solutions https://tnion.com$ 5.69
The new Saudi Riyal sign, everywhere in Odoo
In March 2024 the Saudi Central Bank introduced a dedicated symbol for the Riyal, now encoded as
U+20C1 in Unicode 17.0. Odoo still ships SR as the SAR currency symbol on
versions 16 through 19, and most operating systems do not yet carry a font containing the new sign.
This module fixes both halves of the problem: it sets the correct symbol on the SAR currency and embeds
a font so the glyph actually renders â in the backend, on your website, in the Point of Sale and in
PDF documents.
Before & after
| Where | Standard Odoo | With this module |
|---|---|---|
| Invoice total | SR 1,250.00 | 1,250.00 |
| Product price | SR 49.00 | 49.00 |
| POS screen | SR 18.50 | 18.50 |
Where it applies
The POS bundle is declared without a hard dependency on point_of_sale, so the module installs
cleanly on databases that do not use the Point of Sale at all.
It changes the symbol â not your typography
The embedded font is registered with a CSS unicode-range limited to the Riyal code points
(U+20C1 and the legacy U+E900). The browser is therefore allowed to use it for
one glyph and nothing else.
- Arabic text keeps rendering in your existing font â the module adds no Arabic glyphs.
- Latin text, numerals and headings are visually unchanged.
- Icon fonts such as FontAwesome set their own font-family and are never touched.
- Because of
unicode-range, the font file is downloaded only when a Riyal sign is actually painted â pages without SAR amounts fetch nothing.
A note on PDF reports
Odoo renders PDFs with wkhtmltopdf, whose rendering engine is old and does not support
woff2. The module therefore also ships woff and ttf so wkhtmltopdf
has a format it can load. On a self-hosted server, if a generated PDF still shows an empty box for the
sign, install the bundled saudi_riyal.ttf in the operating system font directory and restart
Odoo â the exact commands for Linux and Windows are in
static/src/fonts/README.txt. Screen, website and POS rendering are unaffected by this and
work out of the box everywhere.
Installation
- Copy the module into your addons path.
- Activate developer mode, then Apps → Update Apps List.
- Search for Saudi Riyal Symbol and click Install.
- Hard-refresh the browser once (
Ctrl/Cmd+Shift+R) so the new asset bundle is picked up.
No configuration screen and no settings to fill in â the symbol is correct the moment installation finishes.
Uninstalling removes the font and the CSS; set the SAR symbol back to SR from
Accounting → Configuration → Currencies if you want the original value restored.
Compatibility
| Odoo version | Edition | Status |
|---|---|---|
| 19.0 | Community & Enterprise | Supported |
| 18.0 | Community & Enterprise | Supported |
| 17.0 | Community & Enterprise | Supported |
| 16.0 | Community & Enterprise | Supported |
Font licence
The bundled Riyal font is the open-source
Saudi-Riyal-Font,
distributed under the SIL Open Font License 1.1. A copy of the licence ships with the module in
static/src/fonts/OFL.txt.
Odoo modules built for the Saudi market. Questions before buying are welcome.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 27 |
| Technical Name |
tds_saudi_riyal_symbol |
| License | OPL-1 |
| Website | https://tnion.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module