Install KDM in ten minutes.
Eight short walkthroughs covering install, rates, windows, popup, pickup, customization, scope grants, and troubleshooting.
Table of contents
Install Kuwait Delivery Manager.
- 01 Open the KDM listing on the Shopify App Store.
- 02 Click Install, then Add app on the Shopify prompt.
- 03 Approve the requested scopes — read_orders, read_customers, read_products, and Shopify Functions.
- 04 KDM seeds your shop with 160 Kuwait areas. This runs once on first install and takes ten seconds.
Set per-area shipping rates.
- 01 Open Apps → Kuwait Delivery Manager → Areas in Shopify admin.
- 02 Each row is a Kuwait area in EN + AR. Click an area to edit.
- 03 Set Delivery price (KWD), Active, Days bookable in advance, and Cutoff hour.
- 04 Save. KDM calls Shopify Functions to register the rate as a native shipping option — visible at checkout within thirty seconds.
- 05 Click Force Sync Rates at the top of the Areas page if a rate has not appeared within a minute.
Configure delivery windows.
- 01 Open KDM admin → Delivery Windows.
- 02 Add a window — name (Morning), start (09:00), end (12:00).
- 03 Set Active days. KDM defaults to Sun-Thu, the Kuwait work week.
- 04 Cap orders per slot if you need capacity limits — Pro plan and above.
- 05 Save. The storefront popup picks up the change within sixty seconds.
Enable the storefront popup.
- 01 KDM injects the popup automatically. No theme code edits, no app block to add.
- 02 The popup appears on the cart page and the cart drawer, above the checkout button.
- 03 After a customer picks an area, a "Selected · Change ›" bar stays visible so they can switch without leaving cart.
- 04 Geolocation auto-detect uses the browser's location with one click to pre-select an area. Pro plan and above.
Customize popup copy and colors.
- 01 Open KDM admin → Settings → Storefront. Basic plan and above.
- 02 Edit EN and AR labels — popup title, button text, slot category headers (Morning / Afternoon / Evening).
- 03 Set popup primary color. Defaults to your theme's accent color.
- 04 Save. Changes are live in under a minute.
Enable click-and-collect. Pro plan and above.
- 01 From Areas, add a row with type set to Pickup.
- 02 Set pickup location name, address, and capacity per slot.
- 03 Customers see a Pickup tab in the popup alongside Delivery.
- 04 The order in Shopify admin shows pickup location and chosen slot.
Grant read_customers if the admin schedule shows "Guest."
- 01 KDM needs the read_customers scope to show real customer names on the schedule page.
- 02 After install or upgrade on a store provisioned before 2026-05-16, Shopify prompts a one-click in-iframe scope grant.
- 03 Click Grant permission. The admin schedule reloads with real names.
- 04 If the prompt does not appear, open Apps → Kuwait Delivery Manager → Schedule and look for the orange banner. Click Grant permission there.
Troubleshooting.
Q. Shipping rates are not showing at checkout.
Click Force Sync Rates on the Areas page. Confirm the area's Active toggle is on and the price is greater than zero.
Q. The popup does not appear on the storefront.
Confirm KDM is installed in Apps. If you uninstalled and reinstalled, areas may need a re-seed — open Areas and click Sync missing Kuwait areas.
Q. Customer name shows as "Guest" in the admin schedule.
See section 07 above — grant the read_customers scope.
Q. Arabic copy is not translating on the AR locale.
Confirm your storefront has the AR locale enabled in Shopify admin → Languages. KDM auto-detects from the Shopify Locale header.
Q. A new Kuwait area is missing from KDM.
Open Areas → Sync missing Kuwait areas. If the area is genuinely new (PAHW just announced it), email support@falaq.solutions with the PACI number.
Still stuck? Email support@falaq.solutions with the five lines from /support.