From 562d79486af97ccbd1373a0f11c99010af72a8ea Mon Sep 17 00:00:00 2001
From: Tal Avital <tal.a@taboola.com>
Date: Tue, 17 Jun 2025 17:52:02 +0300
Subject: [PATCH 1/2] add taboolaId user id submodule documentation

---
 dev-docs/bidders/taboola.md                   |  1 +
 dev-docs/modules/userid-submodules/taboola.md | 64 +++++++++++++++++++
 2 files changed, 65 insertions(+)
 create mode 100644 dev-docs/modules/userid-submodules/taboola.md

diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md
index 2b4572d3cb..cf763dc00f 100644
--- a/dev-docs/bidders/taboola.md
+++ b/dev-docs/bidders/taboola.md
@@ -19,6 +19,7 @@ safeframes_ok: true
 fpd_supported: true
 ortb_blocking_supported: partial
 deals_supported: false
+userIds: taboolaId
 pbs_app_supported: true
 multiformat_supported: will-not-bid
 sidebarType: 1
diff --git a/dev-docs/modules/userid-submodules/taboola.md b/dev-docs/modules/userid-submodules/taboola.md
new file mode 100644
index 0000000000..dce6c5bf39
--- /dev/null
+++ b/dev-docs/modules/userid-submodules/taboola.md
@@ -0,0 +1,64 @@
+---
+layout: userid
+title: Taboola ID
+description: Taboola ID User ID sub-module
+useridmodule: taboolaIdSystem
+bidRequestUserId: taboolaId
+eidsource: taboola.com
+example: '"abc123def456"'
+---
+
+
+
+Taboola is a global leader in powering recommendations across the open web. The Taboola ID module allows publishers to enable identity support for Taboola demand by leveraging a persistent user ID from Taboola's identity infrastructure.
+
+This ID helps improve addressability, performance, and monetization opportunities across Taboola-integrated supply paths, particularly in environments where third-party cookies are limited or unavailable.
+
+The Taboola privacy policy can be found at [www.taboola.com/privacy-policy](https://www.taboola.com/privacy-policy).
+
+Add it to your Prebid.js package with:
+
+```bash
+gulp build --modules=taboolaIdSystem,userId
+```
+
+## Taboola ID Configuration
+
+The Taboola ID module does not require any configuration parameters. If needed, it supports an optional `storage` config to persist the ID locally.
+
+{: .alert.alert-info :}
+NOTE: The Taboola ID module supports both first-party and server-side Prebid identity environments.
+
+
+
+The following configuration parameters are available:
+
+{: .table .table-bordered .table-striped }
+
+| Param under userSync.userIds[] | Scope | Type | Description                                               | Example                                                   |
+| --- | --- | --- |-----------------------------------------------------------|-----------------------------------------------------------|
+| name | Required | String | The name of this sub-module                               | `"taboolaId"`                                             |
+| storage |||                                                           |                                                           |
+| storage.name | Required | String | The name of the cookie or html5 local storage key         | `"taboolaId"` (recommended)                               |
+| storage.type | Required | String | This is where the taboola user ID will be stored          | `"cookie&html5"` (recommended) or `"html5"` |
+| storage.expires | Strongly Recommended | Number | How long (in days) the user ID information will be stored | `365` (recommended)                                       |
+
+
+## Taboola ID Example
+
+```javascript
+pbjs.setConfig({
+       userSync: {
+           userIds: [
+               {
+                   name: 'taboolaId',
+                   storage: {          //Optionally specify where to store the ID, e.g. cookies or localStorage
+                       name: 'taboolaId',
+                       type: 'html5', // or 'html5&cookie'
+                       expires: 365  // days
+                   }
+               }
+           ]
+       }
+});
+```

From e1729556ea709be2c1fb6a201e5c93837f6d4e1d Mon Sep 17 00:00:00 2001
From: Tal Avital <tal.a@taboola.com>
Date: Tue, 17 Jun 2025 18:07:02 +0300
Subject: [PATCH 2/2] fix blank lines

---
 dev-docs/modules/userid-submodules/taboola.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/dev-docs/modules/userid-submodules/taboola.md b/dev-docs/modules/userid-submodules/taboola.md
index dce6c5bf39..5e6cca82e7 100644
--- a/dev-docs/modules/userid-submodules/taboola.md
+++ b/dev-docs/modules/userid-submodules/taboola.md
@@ -9,7 +9,6 @@ example: '"abc123def456"'
 ---
 
 
-
 Taboola is a global leader in powering recommendations across the open web. The Taboola ID module allows publishers to enable identity support for Taboola demand by leveraging a persistent user ID from Taboola's identity infrastructure.
 
 This ID helps improve addressability, performance, and monetization opportunities across Taboola-integrated supply paths, particularly in environments where third-party cookies are limited or unavailable.
@@ -29,8 +28,6 @@ The Taboola ID module does not require any configuration parameters. If needed,
 {: .alert.alert-info :}
 NOTE: The Taboola ID module supports both first-party and server-side Prebid identity environments.
 
-
-
 The following configuration parameters are available:
 
 {: .table .table-bordered .table-striped }
@@ -43,7 +40,6 @@ The following configuration parameters are available:
 | storage.type | Required | String | This is where the taboola user ID will be stored          | `"cookie&html5"` (recommended) or `"html5"` |
 | storage.expires | Strongly Recommended | Number | How long (in days) the user ID information will be stored | `365` (recommended)                                       |
 
-
 ## Taboola ID Example
 
 ```javascript