SDK DocumentationRecipesAnnouncementsSupport Forum
AndroidiOSAnnouncementsSupport Forum

SDK V2 vs SDK V3

On **June 15, 2021**, we released [**SDK V3**](πŸ”—ο»Ώ) - the _preferred_ SDK version for _new_ integrations.

Publishers using **SDK V2** should continue to do so, until instructed otherwise.

## [2.9.2] - 2021-11-02


  • Minor bug fixes.

## [2.9.1] - 2021-06-13


  • Fixed a bug where a certain change in the device orientation caused the Feed to become cropped.

  • Fixed a bug for _API via SDK_ that caused the wrong images to display when reusing cells.

## [2.9.0] - 2021-01-31


  • Fixed a race condition where, in rare cases, privacy status was reported once only for that session (instead of each time that content was fetched).

## [2.8.3] - 2020-12-20


  • Added a new delegate "checkIfVisibleFromScroll" in "API via SDK" to allow publishers to report the SDK when the user is scrolling, instead of having the SDK detect the scrolling on its own. To activate this feature please turn on the "allowScrollReporting" feature flag


  • When the publisher is manually reporting viewability, the SDK will turn off its automatic viewability mechanism.

Xcode 11

If you are using **Xcode 11**, add the following line to your **.xcodeproj/project.pbxproj** file. This line should be added under _both_ `<DEVELOPMENT_TEAM>` entries:

`"EXCLUDED_ARCHS[sdk=iphonesimulator*]" = "";`

## [2.8.2] - 2020-11-04


  • Fixed a rare crash in "API via SDK"

  • Fixed a bug in Feed/Widget via Native where the publisher's ScrollView tag was overridden by the SDK

  • Fixed a rare crash "NSKeyValueObservation" crash when calling "deinit"

## [2.8.1] - 2020-09-22


  • Fixed an issue that added an executable resource to the Carthage binary

  • Restored the "bitcode" option when working with the Carthage binary

## [2.8.0] - 2020-09-08


  • Added support for Apple's iOS 14 "AppTrackingTransparency" framework, that is fetching the IDFA according to the new guidelines


  • Below the engine hood work to improve the way we set code-level feature flags using the `setExtraProperties` function

  • Removed old Apple's deprecated functions from the code

## [2.7.1] - 2020-08-12


  • We made significant improvements in the way we detect and report viewability (when the user sees Taboola); upgrading to this version may result in changes on the "visibility rate" figure in "Interaction Funnel" section in Backstage


  • Fixed a crash that caused Feed/Widget via JS integrations to sometimes crash in iOS 10.x

## [2.6.2] - 2020-06-25


  • Well, it so happens that our iOS SDK had a code comment with the string of "UIWebView"... On April 30th, Apple started to reject new apps that are using UIWebView. When we say "using" it means also code comments with the string of "UIWebView"... We're now fixing it by removing this elusive code comment from `TaboolaView.h`.

## [2.6.1] - 2020-06-21


  • Fixed an issue that caused "executable" warnings when trying to upload a project to the App Store when using the Taboola iOS SDK 2.6.0

  • Fixed an issue that caused the scroll freeze when using iOS SDK 2.6.0 in widget/feed via JS

We are apologizing for the inconvenience caused. We are doing our best to maintain good SDK quality

## [2.6.0] - 2020-06-03


  • Added support for the IAB Transparency and Consent Framework V2 (TCFv2)

  • Added a refresh function to Feed/Widget via JS (SDK for Hybrid apps - SDK JS)

  • Added a function that returns Taboola ScrollView to the publisher in Feed/Widget via Native (SDK Standard) - "getScrollView"


  • We improved the way we report viewability on fast scrolling gestures in Feed/Widget via Native (SDK Standard)


  • Fixed a bug that caused the video to open in fullscreen instead of inline within the feed

  • Crash fixes that we collect using the SDK "global uncaught exception handler"

  • Fixed a crash related to identifying old usage of WIWebView ("exception message: -[__NSCFString hasPrefix:]: nil argument)

## [2.5.0] - 2020-04-26


  • Added a new method to Feed via native that helps the publisher getting back control of the scrolling. Read more [here](πŸ”—ο»Ώ)ο»Ώ

  • Widget/Feed via native: Added new and detailed error strings for the `didFailToLoadPlacementNamed` delegate. To avoid breaking current SDK 2.x integrations, an opt-in feature flag should be used. See more here for [feed](πŸ”—ο»Ώ) and [widget](πŸ”—ο»Ώ)

  • Added "TBL" prefix to the "CCPADataStorageUserDefaults" library to avoid a conflict with other 3rd parties CMP SDKs


  • SDK API is now using delegates instead of observers to improve performance and measurements

  • Improved the way the SDK sends events to Taboola Newsroom integration when in use by the publisher

  • Improved the way we send events to the iOS Global Uncaught Exceptions Handler


  • Fixed an issue in SDK API that prevented sending correct ads preferences signals

  • Fixed an issue where the online HTML template didn't load as a fallback to the local HTML template not loading

## [2.4.1] - 2020-02-25


  • We fixed a bug that prevented some iOS apps from submitting their app to the App Store when using the Taboola iOS SDK (getting `Unexpected CFBundleExecutable key` error)

## [2.4.0] - 2020-02-23


  • Added support to the IAB CCPA framework. The SDK automatically collects the US privacy string if the publisher implements the [IAB spec](πŸ”—ο»Ώ) correctly

  • The iOS SDK framework file is now a dynamic file and not a static file

  • Added GUEH to the iOS SDK (Uncaught exception handler)


  • Well, hmmm, this is a bit embarrassing, but we had a typo (for more than a year @$%@!) on the `setExtraPropetries` function name. We deprecated it and added a new function without any typos - `setExtraProperties`

  • The function `setOptionalPageCommands` is officially deprecated. Please use `setExtraProperties` instead

  • Improved overall performance and removed some rare memory leaks

  • Removed an usage of the clipboard for paring with an internal debugging tool


  • Fixed an issue where the iOS SDK is crashing when the publisher is not using the IAB GDPR framework correctly by setting wrong value types in `NSUserDefaults`

## [2.3.11] - 2020-02-16


  • We had to release another hotfix to make sure our SDK does not conflict with other CMP SDKs.

## [2.3.10] - 2020-02-14


  • We changed the name of the `CMPDataStorageUserDefaults` library in the SDK to `TaboolaCMPDataStorageUserDefaults` to avoid conflicts with other GDPR CMP SDKs

## [2.3.9] - 2020-01-15


  • Added support for dark mode by passing an indication in "setExtraProperties" function, or by listening to the iOS dark mode status. Publishers who are using dark mode themes in their apps must contact their account/solution manager in Taboola to activate the dark mode design. In Q2 2020 this process will be done automatically

  • iOS SDK API will send an indication when the user is limiting ad tracking in the iOS settings


  • The SDK will not include "CoreLocation" library if the publisher app is not already using it


  • Minor bug fixes and performance improvements

## [2.3.8] - 2019-12-4


  • Fixed an issue that prevented previous SDK API versions to use the Click Handler in SDK 2.3.7

## [2.3.7] - 2019-11-26


  • Added support to position `TaboolaWidget` by using Constraints in addition to frames

  • Added the option to hide the scrolling bars for Feed via Native. See the SDK reference to see how


  • The `onItemClick` "placementNamed" is now returning the placement name instead of the item's title

  • Removed the UIWebView API from Widget/Feed via JS to comply with the App Store policy

  • Restored the option to manually report a click event when using SDK API (`handleClickEvent`). Using this method is remotely blocked. To use it, please contact your Solution Manager / Support


  • Fixed an issue where bad items click URLs caused the SDK to stop responding

  • Other minor bug fixes and performance improvements

## [2.3.6] - 2019-10-03


  • Fixed an issue that caused the Feed via Native scrolling not to work when very slowly scrolling on the Feed

## [2.3.5] - 2019-09-23


  • We improved the scrolling in Feed via Native when working with "UIPageViewer" - Taboola SDK returns the scroll back to the publisher app (from the Feed) when switching page, changing orientation, and returning back to the app

  • Minor improvements to the Newsroom events reporting


  • Fixed a collision with "mParticle SDK" that prevented both apps to compile in SDK 2.3.3

  • Other minor bug fixes

## [2.3.3] - 2019-08-07


  • We added support for sending events from the SDK into the Newsroom platform - see dedicated documentation [here](πŸ”—ο»Ώ)ο»Ώ

  • We added a **_optional_** step of initializing Taboola object when the activity loads

  • We added a global exception handler that will help catch errors during the development process


  • We improved the way the SDK handles the network calls


  • Other minor bug fixes and performance improvements

## [2.3.2] - 2019-07-21


  • Fixed an issue that caused a memory leak when using Widget/Feed via Native when Taboola is added to a `UITableViewCell`

## [2.3.1] - 2019-07-09


  • Added a hotfix to protect the app from crashing in Widget/Feed via JS when publisher id setting is missing

## [2.3.0] - 2019-07-02

Version 2.3.0 change log include all of the noatable features that were released in the past 6 months


  • We added support for the IAB Consent framework. You can now pass the GDPR consent status from any CMP that supports the IAB consent string. Read more here: Android - iOS -

  • We added an option to work with UIPageViewController (iOS) and ViewPager (Android) when using SDK JS - calling Taboola only when the next screen (horizontal scrolling) is visible to the user. Read more here: Android - iOS -

  • Added progress bar in Taboola Feed to improve the scrolling experience. Read more here: Android - iOS -

  • Added support for device orientation change when working with Taboola Widget.

  • Added an option to pass the publisher internal user ID, in addition to the device ID. In case you need to pass your own internal ID, you can now do so in addition to the regular attribution that is done based on the device ID (GAID/IDFA). To read more about this feature, please contact your account manager


  • Improved the scroll switch logic when using Taboola Feed.

  • Removed redundant logs and functions "taboolaBridge.emit", "sendClickTracing" and "WKNavigationDelegate".


  • Fixed an issue that caused the iOS SDK JS to crash when using UIPageViewController

## [2.1.6] - 2019-06-05


  • Taboola Android SDK now supports the IAB Consent framework

  • We added an option to pass the SDK an internal user ID

  • We added an option to force CSS rules on the HTML the widget/feed is rendering on - to better support apps that are using dark UI mode

## [2.1.5] - 2019-05-14


  • Taboola Widget (via native) now supports device orientation change


  • We improved the iOS SDK Feed via Native to return the scroll to the publisher app when the user reloads the current screen


  • Fixed an issue that caused too-early viewability reporting on apps that are using UICollectionView

## [2.1.3] - 2019-04-03


  • Added the option to show the progress bar when the publisher is manually handling the scroll switch

  • Added support for 3rd party vendor weather card for SDK via Native


  • Improved automatic scroll switch mechanism, avoiding rare stuck scrolling gestures

  • Removed redundant `WKNavigationDelegate` functions


  • Fixed an issue that caused the progress bar to not show sometimes

  • Other minor bug fixes and performance improvements

## [2.1.2] - 2019-02-25


  • Added support to fetch the item image URL when using specific SDK flavor


  • Under the hood improvements for a specific SDK flavor

  • Improved the manual scroll switch for Feed via Native integration

## [2.1.1] - 2019-02-10


  • We are introducing a native UI indicator when the scroll is switching from the publisher app to Taboola's Feed (Feed via Native)


  • We fixed an issue that miss-identified some tablet devices

## [2.1.0] - 2019-01-01


  • We added a way to manually control the scroll switch when using Feed via Native iOS integration

  • We added an option to lazy load content on our Widget via JS and Feed via JS iOS integrations


  • We improve the way the SDK is working with more online and dynamic under-the-hood components


  • We fixed the logs logic, it will now show only when working in xCode debug mode

  • Minor bug fixes related to custom integrations

## [2.0.34] - 2018-12-19

**Fixed** Memory leak upon destroy. This was a rare issue we eliminated.

## [2.0.30] - 2018-09-16


  • Loading a few widgets on the same page.

  • Prefetching a few widgets on different pages.

## [1.6.14] - 2017-02-21

**Changed** Cache images in NSCachesDirectory

## [1.6.9] - 2017-1-4

**Added** Enable bitcode support.

## [1.6.8] - 2017-12-28

**Changed** An available event is now counted automatically on successful 'getRecommendations' **Added** A method of triggering click handling programmatically for a recommendation item (useful for allowing custom interactions, like swipe)

## [1.6.6] - 2017-11-26


  • DescriptionView where available for recommendation items

  • extraData dictionary with additional API response data elements

## [1.5.0] - 2017-08-16

**Added** TaboolaApi - Taboola SDK API initial versionChangelog