Bulk management

Last edited: 6 May 2026

Bulk management allows you to quickly change or add inventory in Yieldbird Platform by editing Ad Unit properties in an .xlsx file.

Most common use cases are:

• Adding a new Domain and defining multiple Ad Units at once
• Adding new Bidders and defining their bid parameters across multiple Ad Units
• Enabling or disabling Yieldbird modules on multiple Ad Units at once
• Deleting multiple Ad Units at once

How to use Bulk Management?

<aside> <img src="/icons/arrow-right_green.svg" alt="/icons/arrow-right_green.svg" width="40px" />

Good practice: We recommend the following flow for using Bulk Management:

1. First, fully configure at least one Ad Unit on your Domain directly in the Yieldbird Platform.
2. Download the .xlsx file (Download option)
3. Open the file with a program like Microsoft Excel
4. Add new Ad Units by adding new rows in the .xlsx file or modify the parameters in particular columns. Always use the exact taxonomy as in the first line to ensure the inventory is configured as desired.
5. Save the .xlsx file on your computer
6. Upload the new .xlsx file to the Platform

This flow makes it much easier to follow the correct taxonomy for parameters that can be changed in Bulk Management.

</aside>

File format

When downloading the .xlsx file, you can choose between two file format options:

1. Simplified (default) The downloaded file contains only required Bidder parameters. This produces a smaller, easier-to-edit file and is recommended for most use cases.

   <aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" />

   Note: For Bidders with conditionally required parameters (e.g. Adform, Ybidder, Easybid, Nexx360), all parameters for those Bidders are always included regardless of the selected format.

   </aside>

2. Full The downloaded file contains both required and optional Bidder parameters. Use this format only if you need to configure advanced Bidder settings via Prebid Stack.

   <aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" />

   Note: The Full format is available only when the Prebid Stack module is active. If Prebid Stack is inactive, the Full option is visible but disabled.

   </aside>

Upload behaviour

You can upload both Simplified and Full .xlsx files regardless of which format was used to download.

Upload rules:

• If you upload a Simplified file and the Ad Unit already has optional bid parameters configured in the database, those optional parameters remain unchanged.
• Columns with optional bid parameters are always treated as optional by the bulk validator. Missing optional columns do not trigger validation errors.

Deleting Ad Units

To delete an Ad Unit via Bulk Management, set the to_delete column to true for that Ad Unit. After upload, all Ad Units marked with true are removed from the database.

• true: the Ad Unit is deleted
• false or empty: the Ad Unit is not deleted

Removing a row from the .xlsx file does not delete the Ad Unit. Only the to_delete column triggers deletion.

Rules for Making Changes to Inventory Setup via Bulk Management

• If a column (e.g., Media type) is included in the headers but contains only empty fields in the spreadsheet, the script will ignore it. Exception: ignore_viewport_attributes must always be filled in (default value: true).
• All fields that handle data structures such as arrays or hashes (for example, certain bid parameters) must be defined in JSON format.
• Uploading a spreadsheet with empty rows (gaps) will not disrupt functionality, but it may affect validation error reporting. For instance, reported error row numbers may be incorrect.

Data Validation Process

All data imported into the Yieldbird Platform via Bulk Upload is validated to ensure it complies with the required formatting and allowed values. If validation errors are found, the entire upload (import) process stops, and an error message specifying the faulty rows is displayed.

When does bid params validation run?

Bidder bid params are validated only when cs_enabled is set to true for that Bidder in the uploaded file. At that point the system checks both correct types (e.g., integer where integer is required) and completeness (all required parameters present). If either check fails, the upload is rejected.

When cs_enabled is false or left empty, bid params values are stored as-is without validation. Invalid values stored this way may not display correctly in the UI.

Why? This design ensures that a downloaded .xlsx file can always be re-uploaded without modifications, even if it contains pre-existing data for disabled Bidders.

How to access Bulk Management

Bulk Management is available at two levels:

1. Domain level - applies to all Ad Units within the selected Domain.

   Go to Inventory > Domains > edit the Domain > General: Bulk Management

2. Workspace level - applies to all Ad Units across the entire workspace. The downloaded .xlsx file includes an additional column containing the Domain name for each Ad Unit. All other rules and behaviours are identical to Domain-level Bulk Management.

   Go to Global setup > General > Workspace: Bulk Management

<aside> <img src="/icons/arrow-right_green.svg" alt="/icons/arrow-right_green.svg" width="40px" />

Good practice: Use Workspace-level Bulk Management when you need to apply changes across multiple Domains at once, without downloading and uploading separate files per Domain.

</aside>

On this page: