Description
Saudi Address Pro is the definitive address autocomplete solution for WooCommerce merchants operating in Saudi Arabia. Designed to meet the Transport General Authority (TGA) 2026 mandate, our plugin ensures every order is captured with a verified, 100% accurate National Address directly from the Saudi Post (SPL) database.
Service Disclosure
This plugin relies on a third-party service, Saudi Address Pro, to validate addresses and retrieve data from the Saudi Post (SPL) database.
- Service URL: https://saudiaddresspro.com
- Terms of Service: https://saudiaddresspro.com/terms
- Privacy Policy: https://saudiaddresspro.com/privacy
Note: An API Key is required to use the address lookup features. You can obtain a key from the service website. The plugin itself is free and fully functional as a connector; the API service handles the data verification.
The Problem
In the Saudi market, address accuracy is the single biggest barrier to successful last-mile delivery. Customers often struggle to enter complex address details manually, leading to:
- Failed deliveries and returns
- Customer frustration and cart abandonment
- Increased support tickets
- Non-compliance with upcoming regulations
The Solution
Saudi Address Pro allows customers to enter a simple short code (e.g., «RCTB4359»), which instantly auto-fills the complete, official address details—including building number, street name, district, city, and postal code.
Key Features
- Official SPL Database Integration — Connect directly to the authoritative Saudi Post National Address system
- Smart Short Code Autocomplete — Customers type their 4-character, 4-digit code and address fields populate instantly
- TGA 2026 Compliance Ready — Collect compliant addresses today, before the January 1, 2026 deadline
- Seamless Checkout Integration — Non-intrusive widget that enhances existing forms
- Bilingual Support — Full Arabic and English support with RTL
- Zero-Config Field Mapping — Works out of the box with standard WooCommerce checkout
Why Choose Saudi Address Pro?
- Reduce cart abandonment — Faster checkout with fewer keystrokes
- Eliminate address errors — Verified data from official government database
- Ensure compliance — Meet TGA 2026 requirements
- Improve delivery success — Accurate addresses for first-time delivery
Requirements
- WooCommerce 5.0 or higher
- PHP 7.4 or higher
- Saudi Address Pro API key (get one at saudiaddresspro.com)
Privacy Policy
Saudi Address Pro connects to the Saudi Post (SPL) National Address API to retrieve address data. Customer address queries are sent to our API server (saudiaddresspro.com) which forwards requests to the official SPL database.
We do not store customer personal data on our servers. API usage logs are retained for service quality and rate limiting purposes only.
For more information, see our Privacy Policy and Terms of Service.
Installation
- Upload the plugin files to the
/wp-content/plugins/saudi-address-prodirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Navigate to Saudi Address Pro in the admin menu.
- Enter your API key (get one at saudiaddresspro.com/dashboard).
- Configure your preferred language and options.
- Save settings and you’re ready to go!
FAQ
-
Do I need an API key?
-
Yes, a Saudi Address Pro API key is required. You can get one by signing up at saudiaddresspro.com. A 30-day free trial is available.
-
Does this work with guest checkout?
-
Yes, the widget works for both guest and registered customer checkout.
-
Can I use this with custom checkout plugins?
-
Yes, as long as the checkout plugin follows WooCommerce’s standard field naming conventions. For custom field mapping, you can listen for the
saudi_address_selectedJavaScript event. -
Is the short address code required?
-
No, customers can search by typing their full address. The short code is an optional convenience feature that speeds up the process.
-
Does this validate addresses in real-time?
-
Yes, all addresses come directly from the Saudi Post (SPL) database and are verified at the time of selection.
-
Is Arabic supported?
-
Yes, the widget fully supports Arabic with proper RTL (right-to-left) layout. You can configure the language in the settings.
-
What is the TGA 2026 mandate?
-
The Transport General Authority (TGA) of Saudi Arabia has mandated that all parcel deliveries must include a valid National Address starting January 1, 2026. This plugin helps you collect compliant addresses.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Saudi Address Pro” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Saudi Address Pro” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
- WooCommerce checkout integration
- Address autocomplete with short code support
- Admin settings page
- Arabic and English language support
- HPOS (High-Performance Order Storage) compatible