Changing User Agent

Customize the User-Agent string to bypass gateway restrictions and support third-party OAuth logins.

4 min read

Last updated: August 25, 2026

Customize the User-Agent string sent by your Nativine wrapper to bypass gateway restrictions, support third-party logins (like Google OAuth), and ensure seamless mobile rendering.

What is a User-Agent?

A User-Agent (UA) is a string of text that your application sends to the web servers it connects to. It tells the server what browser, operating system, and device type is making the request. By default, Android and iOS WebViews use a generic mobile WebView User-Agent.

Why override the default? Many payment gateways (like Cashfree or Razorpay) and social login providers (like Google) block traffic that identifies as a "WebView" for security reasons. Changing your User-Agent to match a standard mobile browser (like Chrome or Safari) resolves these integration blocks immediately.

Recommended User-Agent Strings

Platform	Recommended User-Agent String
Android	`Mozilla/5.0 (Linux; Android 13; SM-S918B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Mobile Safari/537.36`
iOS	`Mozilla/5.0 (iPhone; CPU iPhone OS 16_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.5 Mobile/15E148 Safari/604.1`

How to Change Your User-Agent

Navigate to the App Builder in your Nativine Dashboard.
Select the Website Overrides tab in the left sidebar.
Locate the User-Agent Override configuration card.
You can either select a preset from the Choose Template Preset dropdown or manually paste a string into the Custom User-Agent String field.
Click Save & Rebuild to apply the changes to your next APK/AAB package.

Common Integration Fixes

Google OAuth Blocking

Google strictly prohibits OAuth flows inside generic WebViews. Setting a standard Chrome/Safari UA bypasses the "disallowed_useragent" 403 error.

Payment Gateway UPI Apps

Gateways like Cashfree look for standard mobile browsers before showing Native UPI Intent buttons. A custom UA ensures they render correctly.

Was this page helpful?

PreviousApp Icons & Splash NextPush Notifications