A word of warning on oa_date - this variable used to be super useful to at least approach empirical analyses of observed embargo periods. I always thought the methodology behind it quite clever for repository-based OA, though not without caveats of course.
From August 2020, the variable oa_date was added to oa_locations, indicating when the full-text document first became available at that location. For repository based OA, oa_date represented the OA-PMH timestamp when the full text article was first detected in the repository. Before the 2025 code rewrite, oa_date was available for 28.4% of repository versions.
After the rewrite, oa_date is populated for all OA repository versions (as well as for all publisher-OA versions), but in all cases, it is set to be equal to the variable published date. This means the variable oa_date can no longer be used to calculate empirical embargo periods, which is relevant both for analysis around OA policies and mandates, and comparative analyses of developments around repositories.
Attached see, as example, an aggregated analysis of oa_date for all best_oa_locations, compared to published_date. This is using Unpaywall data from 2026-08-06.
I honestly don't know why the documentation in OpenAlex still gives the 'old' information on what oa_date entails, but as shown, it currently does not provide any useful information on embargoes...
| oa_status | year | dois | oa_date_null | oa_date_before_published_date | oa_date_same_as_published_date | oa_date_after_published_date |
| bronze | 2026 | 181345 | 0 | 0 | 181345 | 0 |
| closed | 2026 | 2362337 | 2362337 | 0 | 0 | 0 |
| gold | 2026 | 1875597 | 0 | 0 | 1875597 | 0 |
| green | 2026 | 366657 | 0 | 0 | 366657 | 0 |
| hybrid | 2026 | 628075 | 0 | 0 | 628075 | 0 |
| bronze | 2025 | 522008 | 0 | 0 | 522008 | 0 |
| closed | 2025 | 4211450 | 4211447 | 0 | 3 | 0 |
| gold | 2025 | 3426605 | 0 | 0 | 3426605 | 0 |
| green | 2025 | 588919 | 0 | 0 | 588919 | 0 |
| hybrid | 2025 | 1046533 | 0 | 0 | 1046533 | 0 |
| bronze | 2024 | 575772 | 0 | 0 | 575772 | 0 |
| closed | 2024 | 3833831 | 3833828 | 0 | 3 | 0 |
| gold | 2024 | 3237654 | 0 | 0 | 3237654 | 0 |
| green | 2024 | 603275 | 0 | 0 | 603275 | 0 |
| hybrid | 2024 | 895763 | 0 | 0 | 895763 | 0 |
| bronze | 2023 | 624802 | 0 | 0 | 624802 | 0 |
| closed | 2023 | 3801700 | 3801694 | 0 | 6 | 0 |
| gold | 2023 | 3293566 | 0 | 0 | 3293566 | 0 |
| green | 2023 | 564205 | 0 | 0 | 564205 | 0 |
| hybrid | 2023 | 734198 | 0 | 0 | 734198 | 0 |
| bronze | 2022 | 459405 | 0 | 0 | 459405 | 0 |
| closed | 2022 | 3610227 | 3610221 | 0 | 6 | 0 |
| gold | 2022 | 2751203 | 0 | 0 | 2751203 | 0 |
| green | 2022 | 985769 | 0 | 0 | 985769 | 0 |
| hybrid | 2022 | 606314 | 0 | 0 | 606314 | 0 |
| bronze | 2021 | 484161 | 0 | 0 | 484161 | 0 |
| closed | 2021 | 3600433 | 3600427 | 0 | 6 | 0 |
| gold | 2021 | 2633875 | 0 | 0 | 2633875 | 0 |
| green | 2021 | 569581 | 0 | 0 | 569581 | 0 |
| hybrid | 2021 | 499266 | 0 | 0 | 499266 | 0 |
| bronze | 2020 | 512905 | 0 | 0 | 512905 | 0 |
| closed | 2020 | 3732607 | 3732606 | 0 | 1 | 0 |
| gold | 2020 | 2363480 | 0 | 0 | 2363480 | 0 |
| green | 2020 | 604745 | 0 | 0 | 604745 | 0 |
| hybrid | 2020 | 501133 | 0 | 0 | 501133 | 0 |
kind regards,
Bianca Kramer
Sesame Open Science