FAIR

Federated and Independent Repositories

Saudi Address Pro

Plugin Banner

Saudi Address Pro

by SaudiAddressPro

Download
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.

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 – Works with both classic and block-based WooCommerce checkout
  • Bilingual Support – Full Arabic and English support with RTL
  • Zero-Config Field Mapping – Works out of the box with standard WooCommerce checkout
  • Test Connection – Verify your API key works directly from the settings page

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.

  1. Upload the plugin files to the /wp-content/plugins/saudi-address-pro directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Navigate to Saudi Address Pro in the admin menu.
  4. Enter your API key (get one at saudiaddresspro.com/dashboard).
  5. Click “Test Connection” to verify your API key works.
  6. Configure your preferred language and options.
  7. Save settings and you’re ready to go!
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 60-day free trial with unlimited validations is available.

Does this work with the new WooCommerce block checkout?

Yes! Starting from version 1.0.2, the plugin fully supports both the classic WooCommerce checkout and the new block-based checkout (default in WooCommerce 8.3+).

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_selected JavaScript 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.

How can I verify the plugin is working?

Go to the Saudi Address Pro settings page in your WordPress admin and click the “Test Connection” button next to your API key. This will verify your API key and connection to our server.

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.

1.0.3

  • Fixed critical infinite loop in WooCommerce block checkout (WC 8.3+) caused by MutationObserver feedback cycle
  • Improved widget stability: debounced visibility toggling and guarded DOM mutations prevent re-entry loops
  • Widget uses non-animating show/hide in block checkout to avoid DOM mutation cascades
  • Observer auto-cleanup: retry interval stops once widget is positioned and fields are detected
  • Fixed field highlight class changes from re-triggering the block checkout observer
  • Improved region selection and field value setting with mutation guards

1.0.2

  • Added full support for WooCommerce block-based checkout (default in WooCommerce 8.3+)
  • Added “Test Connection” button in admin settings to verify API key
  • Added widget label for better customer clarity (“Saudi National Address”)
  • Improved field detection for block checkout with MutationObserver
  • Added request timeout handling (10 seconds) to prevent stuck searches
  • Fixed search request cancellation when typing quickly
  • Better React-based checkout field value setting for block checkout compatibility
  • Updated WC tested up to 9.6

1.0.1

  • Improved compatibility with caching and optimization plugins (WP Rocket, LiteSpeed Cache, W3 Total Cache)
  • Fixed address search reliability when JavaScript minification is enabled
  • Better error messages in Arabic and English

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
Back to top