Set Up & Configure WebViewGold for iOS
Download the WebViewGold Xcode template, insert your URL in Config.swift, and explore every built-in configuration option — no coding skills required.
Download the WebViewGold app template for iOS here.
Want to avoid installing software? The WebViewGold Cloud Builder (paid add-on) lets you configure, build, and upload your app directly from your browser without opening Xcode.
After downloading the .zip file of WebViewGold from CodeCanyon, there are three setup options for Xcode. Which setup option should be taken is determined by the kind of Mac system you might (or might not) own:
a) You use no Mac system:
If you do not own a Mac for running the required Xcode app, check out MacInCloud as it allows you to rent a virtual Mac online (we are not affiliated with the provider of that service). Using that service, you can build your iOS apps based on WebViewGold, even without using a Mac. Additionally, the WebViewGold Cloud Builder (paid add-on) lets you configure, build, and upload your app directly from your browser without a Mac.
OR
b) You use a Mac system with an Intel chip (detect your chip type):
Download and install the Xcode app from the Mac App Store.
OR
c) You use a Mac system with an Apple Silicon chip (detect your chip type):
Download and install the Xcode app from the Mac App Store. Then follow these steps to run your app using Rosetta:
(Rosetta is a software translation tool which makes the app compatible with the Apple Silicon chip)
Download and install the Xcode app from the Mac App Store. Then follow these steps to run your app using Rosetta:
(Rosetta is a software translation tool which makes the app compatible with the Apple Silicon chip)
- If you are using Xcode 14.3 and above:
- Make sure that you are using macOS Ventura or above.
- Open Xcode. Then in the menu bar, go to Product > Destination > Destination Architectures and select "Show All Destinations".
- This will allow you to run and test your app on Rosetta simulators that are compatible with the app.
- If you are using older Xcode versions (14.2 and below):
- If you are using macOS Ventura (or above), make sure to upgrade to Xcode 14.3 (or above), or your app will not work.
- If you want to test your app on iOS 16.4 and above, make sure to upgrade to macOS Ventura (or above) and Xcode 14.3 (or above).
- Search for the Xcode application in your Applications folder.
- Select the Xcode icon, and then press Command (CMD) + I (or right-click/use the File menu and select Get Info).
- In the newly opened window, check the “Open using Rosetta” checkbox and close the window.
- This will ensure that Xcode always opens with Rosetta.
That's it, Xcode is ready for WebViewGold!
If you’re already running Xcode, please completely quit it (Command/CMD + Q). Then, please open WebViewGold.xcworkspace (instead of WebView.xcodeproj):
Within Xcode, open Config.swift and you will see a document like this:
Here you can set up your app easily. Setting up apps with WebViewGold is very easy and does not require any coding knowledge. Please don't forget to add your Envato/CodeCanyon Purchase Code in the purchasecode field for each app published by you. One license per each customized end product is required. License info of your CodeCanyon purchase: https://codecanyon.net/licenses/standard
Please take a look at this overview of all built-in configuration options:
purchasecode
required value
Enter your Envato/CodeCanyon Purchase Code for this app
app_admin_email
optional
Email address to receive status updates (leave default to disable)
host
required value
Your domain host (e.g., "example.org". By default, WebViewGold for iOS permits both HTTPS content and HTTP content. However, if you prefer to enhance app security by enabling only HTTPS content, there's an option to modify this setting (and/or consider 'blockfaultyandselfsignedhttpscerts' option)
webviewurl
required value
Your full WebView URL (e.g., "example.org/app.html") which should be loaded in the WebView. By default, WebViewGold for iOS permits both HTTPS content and HTTP content. However, if you prefer to enhance app security by enabling only HTTPS content, there's an option to modify this setting (and/or consider 'blockfaultyandselfsignedhttpscerts' option)
uselocalhtmlfolder
true or false
Set to true to use local "local-www/index.html" HTML file instead of remote WebView URL (make sure to not create or use subfolders within local-www)
openallexternalurlsinsafaribydefault
true or false
Set to true to open all external hosts in Safari
safariwhitelist
List
Add domains here that should always be opened in Safari, regardless of what the openallexternalurlsinsafaribydefault option is set to; to add another domain, insert another host like so: ["alwaysopeninsafari.com", "google.com", "m.facebook.com"] please enter the host exactly how you link to it (with or without www, but always without http/https)
safariblacklist
List
Add domains here that should never be opened in Safari, regardless of what the openallexternalurlsinsafaribydefault option is set to; to add another domain, insert another host like so: ["alwaysopeninsafari.com", "google.com", "m.facebook.com"] please enter the host exactly how you link to it (with or without www, but always without http/https)
openspecialurlsinnewtab
true or false
Set to true to open links with attributes (e.g., _blank) in a new in-app tab by default
openspecialurlsinnewtablist
List
Add special URLs (e.g., _blank) here that should ALWAYS open in a new in-app tab
enableBioMetricAuth
true or false
Set to true to enable our App Lock feature, which requires Face ID, Touch ID, or Code authentication for the app. This is an independent and additional option to our JavaScript-based Bio Auth API
autoInjectVariable
true or false
Set to true to automatically load JavaScript variables (e.g., UUID, app version, OneSignal and Firebase subscription IDs, and App Store location) without needing to call specific URLs like get-uuid:// (this currently supports app version, OneSignal and Firebase subscription IDs, UUID, and App Store location)
disablecallout
true or false
Set to true to remove WKWebView 3D touch Link Preview/callout window for links (recommended for most cases)
deletecache
true or false
Set to true to clear the WebView cache & cookies on each app startup and do not use cached versions of your web app/website
deletecacheonexit
true or false
Set to true to clear WebView cache & cookies upon full app exit (you might also want to activate deletecache, as iOS version differences could affect reliability)
okbutton
optional
Set the text label of the "OK" buttons (translatable via alternatelanguage1/alternatelanguage2)
cancelbutton
optional
Set the text label of the "Cancel" buttons (translatable via alternatelanguage1/alternatelanguage2)
bigstatusbar
true or false
Set to true to enhance the Status Bar size
hideverticalscrollbar
true or false
Set to true to hide the vertical scrollbar
hidehorizontalscrollbar
true or false
Set to true to hide the horizontal scrollbar
enableswipenavigation
true or false
Set to false to prevent swipe left/right from triggering backward/forward navigation
orientationiphone
"portrait", "landscape" or "auto"
Set the orientation to either portrait, landscape, or auto on iPhone
orientationipad
"portrait", "landscape" or "auto"
Set the orientation to either portrait, landscape, or auto on iPad
preventsleep
true or false
Set to true to prevent the device from going into sleep while the app is active
preventZoom
true or false
Set to true to disable user zoom by injecting code that prevents zooming on the website
preventoverscroll
true or false
Set to true to remove WKWebView bounce animation (recommended for most cases). Set to false if using pull to refresh.
enhanceUrlUUID
true or false
Set to true to add the UUID parameter 'uuid=XYZ' to the first URL request
linkDragAndDrop
true or false
Set to false to disable link drag and drop
useShortcuts
true or false
Set to true to register dynamic shortcuts defined in Shortcuts.json
pulltorefresh
true or false
Set to true to enable pull to refresh in your app. Note that to enable this feature, preventoverscroll needs to be set to false. Additionally, you can always call
enablepulltorefresh:// or disablepulltorefresh:// from your website to activate or deactivate pull-to-refresh dynamically.pulltorefresh_loadingsigncolour_lightmode
Color
Set the colour of the pull to refresh loading sign in light mode
pulltorefresh_backgroundcolour_lightmode
Color
Set the colour of the pull to refresh background in light mode
pulltorefresh_loadingsigncolour_darkmode
Color
Set the colour of the pull to refresh loading sign in dark mode; requires iOS 13 or higher
pulltorefresh_backgroundcolour_darkmode
Color
Set the colour of the pull to refresh background in dark mode; requires iOS 13 or higher
useragent_iphone
optional
Define a customized UserAgent on iPhone (or leave it empty to use the default iOS UserAgent)
useragent_ipad
optional
Define a customized UserAgent on iPad (or leave it empty to use the default iOS UserAgent)
google_login_helper_triggers
optional
Define the URL prefixes that load during Google login for your website; acts as a trigger for the helper; Example: ["https://accounts.google.com", "https://accounts.youtube.com"]
facebook_login_helper_triggers
optional
Define the URL prefixes that load during Facebook login for your website; acts as a trigger for the helper; Example: ["https://www.facebook.com", "https://m.facebook.com"]
activatefirstrundialog
true or false
Set to true to activate the "First run" dialog
firstrunmessagetitle
optional
Set the title label of the "First run" dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
firstrunmessage
optional
Set the message of the "First run" dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
askforpushpermissionatfirstrun
true or false
Set to true to ask your users for push notifications permission at the first run of your application. Set it to "false" to never ask or to ask with a registerpush:// link/button/redirection in your web app later
offlinetitle
optional
Set the title label of the Offline dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
offlinemsg
optional
Set the text of the Offline dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
screen1
optional
Set the text label 1 of the Offline screen (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
screen2
optional
Set the text label 2 of the Offline screen (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
offlinebuttontext
optional
Set the text label of the Try again button (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
offlinescreenautoretry
true or false
Set to true if app should automatically retry to connect every second (even without button tap)
activateratemyappdialog
true or false
Set to true to activate the "Rate this app on App Store" dialog
activatefacebookfriendsdialog
true or false
Set to true to activate the "Follow on Facebook" dialog
becomefacebookfriendstitle
optional
Set the title label of the "Follow on Facebook" dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
becomefacebookfriendstext
optional
Set the text label of the "Follow on Facebook" dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
becomefacebookfriendsyes
optional
Set the text label of the "Yes" button of the "Follow on Facebook" dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
becomefacebookfriendsno
optional
Set the text label of the "No" button of the "Follow on Facebook" dialog (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
becomefacebookfriendsurl
optional
Set the URL of your Facebook/Instagram/YouTube/... page (e.g., "https://facebook.com/OnlineAppCreator/")
imagedownloadedtitle
optional
Set the title label of the "Image saved to your photo gallery" dialog box (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
imagenotfound
optional
Set the title label of the "Image was not found" dialog box (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
transparentStatusBar
true or false
Set to true to make the status bar transparent, allowing web content to render behind it
autoAdjustSafeAreaInsets
true or false
Set to false if your website already handles safe area insets (use with transparentStatusBar)
statusBarBackgroundColor
Color
Define a custom status bar background color
darkModeStatusBarBackgroundColor
Color
Define a custom status bar background color while user is using iOS Dark Mode
statusBarTextColor
white or black
Define the text color of the status bar
darkModeStatusBarTextColor
white or black
Define the text color of the status bar while user is using iOS Dark Mode
showNavFooter
true or false
Set to true to enable the native navigation footer bar (configured via FooterBar.json)
bottombar
true or false
Set to true to enable the bottombar to prevent the home bar (found in iOS devices with no home button, eg. iPhone X) from overlapping app content
iPadBottombar
true or false
Set to true to ALSO enable the bottombar on iPads (which have bigger screens, so the home bar may not overlap content due to a different layout, hence the bottombar may not be needed)
bottombarBackgroundColor
Color
Define a custom bottom bar background color
darkmodeBottombarBackgroundColor
Color
Define a custom bottom bar background color while user is using iOS Dark Mode; requires iOS 13 or higher
qrcodelinks
0 or 1 or 2 or 3 or 4
Set to (0) to open a scanned QR code URL in the app; (1) in an in-app tab; (2) in a new browser; (3) in an in-app tab if external; (4) in a new browser if external; moreover, you can optionally limit the allowed QR code scanner prefixes in the "allowedQRurls" array of the SwiftQRScanner.swift file
ShowExternalLink
optional
Set to true open links sent through Universal Links API (syntax: https://example.org) and Deep Linking API (syntax: example://url?link=https://example.org).
splashScreenEnabled
optional
Set to false if you want to disable the Splash Screen while the app launches and display the Loading Sign instead
remainSplashOption
optional
Set to true if you want to display the Splash Screen until the initial loading of your homepage is complete (instead of the Loading Sign)
splashTimeout
number value (milliseconds)
Set the splash screen timeout in milliseconds (the loading sign screen will show after this time duration if the home URL still has some loading to do)
scaleSplashImage
percentage value [0-100]
Set the splash screen image size with respect to the device's smallest width/height; range in percentage [0-100]; value = 0 will hide the image completely, value = 100 will display the image in full-screen mode
useLoadingSign
true or false
Set to false to hide the loading sign while loading your URL
useLoadingProgressBar
true or false
Set to true to use the loading progress bar while loading your URL (instead of the loading sign)
loadingIndicatorColor
Color
Set a color for the loading indicator
alternativeAppIconNames
List
Edit this list to change the file names of your alternative app icons
backgroundlocation
true or false
Set to true to allow background location access (additionally, ensure "Background Modes" capability in the Xcode project settings includes "Location updates". Additionally, depending on your web app, you may need to activate “Background Processing” (in this case, also add an array to your Info.plist file with the key “Permitted background task scheduler identifiers" – under this array, include a string with your app bundle ID, e.g., "com.onlineappcreator.webviewgold")
appendlanguage
true or false
Set to true if you want to extend URL request by the system language like ?webview_language=LANGUAGE CODE (e.g., ?webview_language=EN for English users)
blockfaultyandselfsignedhttpscerts
true or false
Set to true to block content signed with self-signed SSL (user) certificates & faulty SSL certificates; maybe also consider blocking all Non-HTTPS content
jailbreakBlock
true or false
Set to true to block the app on jailbroken/hacked devices. Note: Detection is not foolproof but employs multiple methods to identify jailbreaks and hacks
autoRefreshEnabled
true or false
Set to true if you want the WebView to automatically refresh its contents when the app comes back to the foreground from the background.
offlinelocalhtmlswitch
true or false
Set to true if you want to use the "local-html" folder if the user is offline, and use the remote URL if the user is online..
extentionARY
List
Add the file formats that should trigger the file downloader functionality (e.g., .pdf, .docx, ...)
autodownloader
true or false
Set to true if you want to activate the downloader functionality based on Content-Disposition HTTP headers, regardless of the file formats listed in the extentionARY variable above
splashscreencolor
Color
Set a background color for the splash screen
extentionARY
List
Add the file formats that should trigger the file downloader functionality (e.g., .pdf, .docx, ...)
offlinelocalhtmlswitch
true or false
Set to true if you want to use the "local-html" folder if the user is offline, and use the remote URL if the user is online.
zipfiledownloadfromserver
true or false
Set to true to download a .zip archive from a remote URL that should be extracted and presented if the user is offline (also, please turn the variable turnofflinelocalhtmlswitch to true); the update will take place with every full restart of the app
zipfileremoteurl
URL
The. zip archive from a remote URL that should be extracted and presented if the user is offline
zipfilename
file name
The internal file name of the .zip file on the user device (recommended to not change)
zipfileextractpath
folder name
The internal folder name of the extract path on the user device (recommended to not change)
zipfileextractindexindex
file name
The file that should be opened first within the extracted .zip archive
zipfilepopuptitle
text
The title of the popup that will be displayed while downloading the .zip file (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
zipfilepopupmessage
text string
The message of the popup that will be displayed while downloading the .zip file (if you like, you have the ability to translate this string into two additional languages using the 'alternatelanguage1' and 'alternatelanguage2' strings found at the end of Config.swift file)
InAppPurchAppBundleIdentifier
optional
Set the Default App Identifier in order to activate In-App Purchase API for the default IAP product (details can be configured in App Store Connect)
IAPSharedSecret
optional
Set the App Secret in order to activate In-App Purchase API (more information can be found here)
iapsuccessurl
optional
Set the Default URL that should be opened after a successful In-App Purchase/In-App Subscription through the WebView wrapper. The URL could be "https://www.example.org/thanks.php," for example, and thanks.php could set the lifetime cookie for premium content.
iapexpiredurl
optional
Set the Default URL that should be opened after an In-App Subscription through the WebView wrapper expired. The URL could be "https://www.example.org/expired.php," for example, and expired.php could remove the cookie for premium content
revenueCatAPIKey
optional
Your RevenueCat API Key (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/api-key-revenuecat how to find it)
revenueCatProjectID
optional
Your RevenueCat Project ID (sign up via tinyurl.com/register-revenuecat first, then follow tinyurl.com/project-id-revenuecat how to find it)
oneSignalID
optional
Required for OneSignal push functionality
kPushEnabled
true or false
Set to true to activate the OneSignal push functionality
kPushEnhanceUrl
true or false
Set to true if you want to extend WebView Main URL requests by the OneSignal subscription ID in the ?onesignal_push_id=XYZ format (alternatively and additionally, you can always request the OneSignal subscription ID by calling getonesignalplayerid:// or even get it automatically if you turn "autoInjectVariable" to "true" in Config.swift)
kPushReloadOnUserId
true or false
Set to true if WebView should be reloaded after receiving the UserID from OneSignal
kPushOpenDeeplinkInBrowser
true or false
Set to true to open deeplinking URLs from OneSignal in the Safari browser instead of the main WebView; important: For sending notifications with a link from OneSignal, do NOT use 'Launch URL' instead, you must use an 'Additional Data Field', with key: url and value: the link you want to use
kFirebasePushEnabled
true or false
Set to true to connect your app to the Firebase Push Services
kFirebaseEnhanceUrl
true or false
Set to true if you want to extend WebView Main URL requests by ?firebase_push_id=XYZ (alternatively and additionally, you can always request the OneSignal subscription ID by calling getfirebaseplayerid:// or even get it automatically if you turn "autoInjectVariable" to "true" in Config.swift)
firebaseTopic
optional
Set a Firebase Topic to subscribe to
kPushwooshEnable
optional
Set to true to activate the Pushwoosh push functionality (set ID in Info.plist in Pushwoosh_APPID column)
kPushwooshEnhanceUrl
optional
Set to true to true if you want to extend WebView Main URL requests by ?pushwoosh_id=XYZ
showBannerAd
true or false
Set to true if you want to show AdMob banner ads (please also set AdMob IDs in Config.swift & Info.plist, see here)
showFullScreenAd
true or false
Set to true if you want to show AdMob interstitial ads after X website clicks (please also set AdMob IDs in Config.swift & Info.plist, see here)
showadAfterX
optional
Define number X to show an AdMob interstitial ads after each X (e.g., 10) website clicks or screen taps, depending on what incrementWithTaps is set to (please also set AdMob IDs in Config.swift & Info.plist, see here).
incrementWithTaps
true or false
Sets to true if you want to show interstitial ads after X screen taps, or false after X website redirects.
enableRewardedAds
true or false
Set to true to enable AdMob rewarded ads. Required to be true even for manual activation of ads.
useRewardedAdsWherePossible
true or false
Set to true to display Admob rewarded ads instead of admob interstitial ads, i.e after x taps etc. Keep as false if their activation should be handled via your website's code. Requires showFullScreenAd to also be set to true in order to overwrite them
admobadstriggerurls
optional
Add page trigger words here, presence in a URL triggers AdMob interstitial ads (e.g., ["see-highscore.php", "/thank-you/", "/next-step.html"])
useFacebookAds
true or false
Set to true to activate Facebook Interstitial Ads
facebookAdsID
optional
Enter your Placement ID, available when you create a property on Facebook Monetization manager, and connect an iOS app. The ID will look like this: 3937960198956424_3969441893142587
useTimedAds
true or false
Use timed ads for Facebook Ads (e.g., every 60s) as opposed to ads every X clicks
fbadstriggerurls
optional
Add page trigger words here, presence in a URL triggers a Facebook ad (e.g., ["see-highscore.php", "/thank-you/", "/next-step.html"])
showFBAdsEveryNSeconds
optional
Show a Facebook Interstitial Ad every X seconds; 120s and above is recommended
ATTDeniedShowAds
true or false
Set to false to stop showing ads entirely if the user denies the AppTrackingTransparency (ATT) permission
useAdsenseAds
true or false
Set to true to enable support for AdSense web ads (independent of AdMob ads)
askForAdConsent
true or false
Set to false if you want to deactivate Google consent management for AdMob (check https://support.google.com/admob/answer/13554116 upfront)
showBarcodeScanner
true or false
Set to false to block website requests to turn on the Barcode Scanner using
barcodescanner://kFlashLightEnabled
true or false
Set to false to block website requests to turn on the flashlight using
enableflashlight://widgetRefreshTime
Number
Refresh interval for the widget in minutes
widgetfallbackURL
String
Fallback image URL used by the widget
preventScreenCapture
true or false
Set to true to call onScreenCaptureAttempt in your web app on screenshots or screen recordings
siriEnabled
Plugin Token
Enter token to enable Siri plugin functionality
NFCEnabled
Plugin Token
Enter token to enable NFC plugin functionality
HealthKitEnabled
Plugin Token
Enter token to enable HealthKit plugin functionality
alternatelanguage1_langcode (& _alternatelanguage1_ string list)
true or false (& string list)
Set language code or leave this string empty to not use alternate language #1 strings (string list at the bottom of Config.swift file); if you want to activate this alternate language, please use the two-letter code that adheres to the ISO 639-1 language code standard (e.g., "de" for German, "fr" for French, "it" for Italian, "pt" for Portuguese, "ca" for Catalan, "es" for Spanish, …)
alternatelanguage2_langcode (& _alternatelanguage2_ string list)
true or false (& string list)
Set language code or leave this string empty to not use alternate language #2 strings (string list at the bottom of Config.swift file); if you want to activate this alternate language, please use the two-letter code that adheres to the ISO 639-1 language code standard (e.g., "de" for German, "fr" for French, "it" for Italian, "pt" for Portuguese, "ca" for Catalan, "es" for Spanish, …)
SDK-style implementation notes
Treat this feature as a native capability exposed to your web layer: keep your production website or PWA as the source of truth, then use the documented WebViewGold configuration flags, URL commands, and JavaScript bridge calls to opt in to native iOS behavior only where it adds value. This approach keeps your codebase maintainable because the same web application can serve browsers, WebViewGold for iOS, and the other WebViewGold platforms with minimal conditional logic.
For reliable results, prefer HTTPS endpoints, stable route names, explicit success/error states in your UI, and small JavaScript helper functions that wrap native calls. For example, a web app built with jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, a custom React/Vue/Angular stack, or static HTML can expose a single button or event handler that triggers the native WebViewGold API while still showing a graceful browser fallback.
- Recommended integration pattern: detect the app context, call the WebViewGold API, then update your web UI after the native callback or route change.
- Testing checklist: validate the feature on a real device or packaged build, verify permissions and store review text, and confirm that browser-only users still receive a useful fallback.
- SEO benefit: keep feature pages, route titles, and structured content indexable on your website while WebViewGold delivers the native app shell for iOS users.