From 6162c5f6d2050a648e7651eb155e4f010513b990 Mon Sep 17 00:00:00 2001 From: Marcin Komorski Date: Thu, 15 Jan 2026 10:12:14 +0100 Subject: [PATCH] alwaysHasCapacity flag --- dev-docs/bidder-adaptor.md | 4 +++- dev-docs/modules/prebidServer.md | 1 + dev-docs/publisher-api-reference/setConfig.md | 8 ++++++++ 3 files changed, 12 insertions(+), 1 deletion(-) diff --git a/dev-docs/bidder-adaptor.md b/dev-docs/bidder-adaptor.md index 6836a1506f..2926915754 100644 --- a/dev-docs/bidder-adaptor.md +++ b/dev-docs/bidder-adaptor.md @@ -238,7 +238,8 @@ export const spec = { onSetTargeting: function(bid) {}, onBidderError: function({ error, bidderRequest }) {}, onAdRenderSucceeded: function(bid) {}, - supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO] + supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO], + alwaysHasCapacity: true // When true, this bidder will be omitted in checking if origin has http capacity } registerBidder(spec); @@ -1190,6 +1191,7 @@ export const spec = { code: BIDDER_CODE, gvlid: 0000000000, supportedMediaTypes: [BANNER, VIDEO, NATIVE], + alwaysHasCapacity: true, aliases: [{code: "myAlias", gvlid: 99999999999} ], /** * Determines whether or not the given bid request is valid. diff --git a/dev-docs/modules/prebidServer.md b/dev-docs/modules/prebidServer.md index 627a94a890..50bfac23b0 100644 --- a/dev-docs/modules/prebidServer.md +++ b/dev-docs/modules/prebidServer.md @@ -99,6 +99,7 @@ There are many configuration options for s2sConfig: | `customHeaders` | Optional | Object | These custom headers will be included in the XHR call to the bidder's endpoint. This will allow you to send data specific to your use case. The format consists of an object where the keys represent the header names and the values correspond to the respective header values. Here is an example how a customHeader object might look like - `{"Header1": "Value1", "Header2": "Value2"}`| | `endpointCompression` | Optional | Boolean | Gzip compress the auction request payload when supported and debug mode is off. Adds `gzip=1` to the request URL. | | `filterBidderlessCalls` | Optional | Boolean | When `true`, ad units that have no bidders defined are excluded from Prebid Server requests. Defaults to `false`. | `true` | +| `alwaysHasCapacity` | Optional | Boolean | When `true`, this prebid server instance will be omitted in checking if origin has http capacity, defaults to `false` | If `endpoint` and `syncEndpoint` are objects, these are the supported properties: diff --git a/dev-docs/publisher-api-reference/setConfig.md b/dev-docs/publisher-api-reference/setConfig.md index 2e9c9916eb..dbb448523d 100644 --- a/dev-docs/publisher-api-reference/setConfig.md +++ b/dev-docs/publisher-api-reference/setConfig.md @@ -115,6 +115,14 @@ pbjs.setConfig({ maxRequestsPerOrigin: 6 }); pbjs.setConfig({ maxRequestsPerOrigin: 1 }); ``` +Note: Prebid adapters or Prebid Server instances can be omitted from this capacity check if they declare `alwaysHasCapacity: true`. See [bidder adapter configuration](/dev-docs/bidder-adaptor.html) and [Prebid Server configuration](/dev-docs/modules/prebidServer.html) for more details. + +Although, `maxRequestsPerOrigin` can still be forced by the publisher using: + +```javascript +pbjs.setConfig({ maxRequestsPerOrigin: 1, forceMaxRequestsPerOrigin: true }); +``` + ### Disable Ajax Timeout