Theme Specification and Custom Liquid Development
A written theme spec precedes all development. Custom Liquid is written to support both Arabic RTL and English LTR within the same theme. This covers section schema, block-level directionality, conditional rendering based on active locale, and correct handling of typographic conventions for both scripts.
Arabic RTL and Shopify's Native RTL Support
Shopify's native RTL support provides the CSS and Liquid foundation for Arabic storefronts. Custom Liquid development extends this foundation to cover edge cases: third-party app blocks that inject LTR content, custom section layouts where flexbox or grid direction needs explicit locale-aware handling, icon and image directionality, and form field alignment. The output is an Arabic storefront where direction is consistent throughout, not just in the theme's default sections.
Bilingual Content Architecture
Managing Arabic and English content on a single Shopify store requires a structured approach. Shopify's native translation system (Translate and Adapt) and third-party translation apps handle the storefront language layer. The data architecture underneath, including metafield schema, collection structure, and page templates, needs to be designed to support bilingual content without creating maintenance overhead. We design this architecture from the start so it scales.
Metafield Architecture
Metafields extend the product data model beyond Shopify's default fields. For Qatar merchants with Arabic-language product attributes, we design the metafield namespace and key structure to support bilingual data, build definitions in the admin, and wire them into Liquid templates across product, collection, and page contexts.
Payment Integration: Telr and PayTabs
Shopify Payments is not available in Qatar. Telr and PayTabs are both established payment processors with Shopify integration support for the GCC market. Integration covers gateway configuration, checkout payment flow, order management in the Shopify admin, and testing across card payment, and where applicable, additional payment methods relevant to the Qatar market. PCI compliance considerations are documented as part of the handover.
Shopify Markets for Multi-Currency: QAR, USD, SAR, AED
Shopify Markets is configured for the Gulf market with QAR as the base currency and USD, SAR, and AED as additional markets. Configuration covers currency display formatting, market-specific pricing rules, and correct currency presentation at checkout for each market. Geolocation-based market assignment is configured so customers are routed to the correct currency from session start.
Collection Filtering and Product Page Templates
Collection filtering is built to work correctly in both Arabic and English, with filter labels and taxonomy mapped to the actual product catalogue in both languages. Product page template routing handles different product types for each market and language context.
Checkout Configuration
Checkout language, payment method display, and address field configuration are set for both Arabic and English checkout flows. For Plus merchants, checkout UI extensions allow more precise bilingual and market-specific customisation within the checkout.
App Integration and Audit
Third-party apps are reviewed for RTL compatibility and performance cost. Apps that inject LTR-only code into the storefront are identified and either replaced or wrapped with directional CSS fixes. Apps that duplicate native functionality are removed.
Performance Optimisation
Core Web Vitals are measured and addressed at the theme level. Arabic font loading for both display and body text is optimised, as Arabic web fonts can have a significant impact on Largest Contentful Paint if not loaded correctly.
Analytics
GA4 implementation with correct market attribution across all Shopify Markets configurations. Analytics event tracking is set up to distinguish QAR, SAR, AED, and USD transactions by market.