Web SDK v1.6 Changelog

Release Date: March 2026
Status: Current production version

What's New in v1.6.0

This version introduces full Right-to-Left (RTL) layout support and Arabic language localization, enabling merchants to serve Arabic-speaking customers with a natively adapted checkout experience.

RTL Layout Support

Full Right-to-Left rendering for the entire checkout UI.

1. Automatic RTL Detection

The SDK now detects RTL languages and automatically mirrors the entire UI — form fields, icons, tooltips, payment screens, and error messages all render right-to-left without any additional merchant configuration.

2. language: "ar" Configuration

Pass language: "ar" in the startCheckout configuration to activate RTL mode. No other setup is required.

await yuno.startCheckout({
  checkoutSession,
  elementSelector: '#root',
  countryCode: 'SA',
  language: 'ar',   // Activates RTL layout automatically
  // ... other configuration
});

Arabic Language Support

Complete Arabic localization across all checkout flows.

3. Arabic (ar-SA) Translation Bundle

All checkout flows now include full Arabic translations, covering form labels, error messages, placeholders, and payment instructions. language: "ar" is now a valid configuration option.

Breaking Changes

RTL support required a foundational CSS migration that may affect merchants who apply custom styles to SDK elements.

Impact on Merchants

DOM Structure Change

When an RTL language is active, a dir="rtl" wrapper element is added around the SDK app. Merchants using CSS selectors or custom styles targeting SDK elements should review whether this new wrapper affects their overrides.

CSS Override Behavior

CSS logical properties resolve based on writing direction. LTR languages render visually the same as before. However, if your integration overrides SDK styles using fixed directional properties, those overrides may behave differently.

What to check
Search your custom stylesheets for margin-left, margin-right, padding-left, padding-right, text-align: left/right, and directional border-radius values applied to SDK elements. Replace these with CSS logical equivalents where needed.

Script Tag

Update your script source to use v1.6.0:

<script src="https://sdk-web.y.uno/v1.6/main.js" defer async></script>

Migration from v1.5

LTR-Only Integrations (Most Merchants)

No code changes are required. The visual output for LTR languages is identical to v1.5. Follow this checklist:

Update your script tag to point to v1.6.0
Audit any custom CSS targeting SDK elements for fixed directional properties
Replace directional properties with CSS logical equivalents where found
Test your checkout UI to confirm layout is unchanged

Enabling Arabic / RTL

To serve Arabic-speaking customers with the full RTL checkout experience:

Update your script tag to point to v1.6.0
Pass language: "ar" in your startCheckout call
Set the appropriate country code for your market (e.g., SA, AE, EG)
Test the full checkout flow in RTL to confirm layout, labels, and error messages render correctly

await yuno.startCheckout({
  checkoutSession,
  elementSelector: '#root',
  countryCode: 'SA',
  language: 'ar',
  // ... other configuration
});