Coming Changes ONIX (2026) - v3
- 1 Changelog
- 2 Introduction
- 3 Introducing a new export-endpoint (v3)
- 4 Schedule / Status
- 5 Feature / change
- 5.1 Sales Restrictions Breaking CHANGE
- 5.2 ProductIdentifier Breaking CHANGE
- 5.3 Sales rights Breaking CHANGE
- 5.4 TextContent in multiple languages Breaking CHANGE
- 5.5 Contributor
- 5.5.1 ISNI
- 5.5.2 Nametype
- 5.5.3 ContributorRole
- 5.5.4 Contributor - detailed fields
- 5.6 Name as subject
- 5.7 Publishing date Breaking CHANGE
- 5.8 Product classification
- 5.9 Main subject
- 5.10 TextContent for reviews
- 5.11 MarketPublishingStatusNote Breaking CHANGE
- 5.12 MarketPublishingStatus Breaking CHANGE
- 5.13 EUDR, FSC, PEFC, carbon emission
- 5.14 EpubUsageLimit for digital learning resources
- 5.15 EndDate for Subscription services
Changelog
Date |
|
|---|---|
Apr 10, 2026 | Postponed some of the import-features. Added EndDate for subscription services. |
23.2.2026 | Changed specification for Publication year in accordance with new code in issue 73 of the codelists |
Jan 30, 2026 | Added support for RegionsIncluded/CountriesExcluded in Territory (in Market) - for SalesRestrictions |
Jan 15, 2026 | Split the status-table in import and export to give a simpler overview. Marked several export-features as ready (SalesRestrictions, SalesOutlet, FCS, (EUDR) etc., TextContent. Contributor, NameAsSubject, PublishingDate, MainSubject, TextContent for reviews) |
Jan 15, 2026 | Updated with EUDR, FSC, carbon emission etc. Both import and export |
Jan 8, 2026 | Published |
Introduction
Revision of the SalesRestriction-composite will be made to accommodate the need to express restrictions both for streaming services and for single sales. Since implemented by Bokbasen, the composite and the codelists have been revised and expanded, allowing more precise and standardized expression of restrictions.
Bokbasen will implement support for Sales outlet codes from list 139, to identify retailers and streaming services.
Other changes will be implemented as specified, f.i. support information about FSC, PFEC, carbon emissions, for regions in the Sales rights composite, TextContent in multiple languages, revision of the Contributor composite etc.
Introducing a new export-endpoint (v3)
Since these are breaking changes, they will be served from a new endpoint
Onix Export v2 - end of life 30.06.2026
All customers must move to v3 before this date.
Onix Export v3 - ready with all breaking changes 31.01.2026
Non-breaking changes will be added after the initial release-date.
Schedule / Status
Import (Onix to Bokbasen)
Feature | Available from | Breaking change? | Status |
|---|---|---|---|
SalesRestrictions | Q2 2026 |
|
|
SalesOutlet | Q1 2026 |
| ready |
FCS, (EUDR) etc. | Q1 2026 |
| ready |
SalesRights | Q3 2026 |
|
|
TextContent - multiple languages | Q2 2026 |
| ready |
Contributor - subfields | Q1 2026 |
| ready |
Contributor - ISNI | Q1 2026 |
| ready |
ProductClassification (HS-codes) | Q2 2026 |
|
|
PublishingDate | Q2 2026 |
|
|
MainSubject | Q2 2026 |
|
|
TextContent for reviews | Q1 2026 |
|
|
EpubUsageLimit | Q2 2026 |
| ready |
EndDate | Q2 2026 |
|
|
Export (Onix from Bokbasen)
Feature | Available from | Breaking change? | Status |
|---|---|---|---|
SalesRestrictions | Jan 31, 2026 | Breaking CHANGE | ready |
SalesOutlet | Jan 31, 2026 | Breaking CHANGE | ready |
ProductIdentifier | Jan 31, 2026 | Breaking CHANGE | ready |
FCS, (EUDR) etc. | Q1 2026 |
| ready |
SalesRights | Jan 31, 2026 | Breaking CHANGE | ready |
TextContent - multiple languages | Jan 31, 2026 | Breaking CHANGE | ready |
Contributor - subfields | Q1 2026 |
| ready |
NameAsSubject | Q1 2026 |
| ready |
ProductClassification (HS-codes) | Q2 2026 |
|
|
PublishingDate | Jan 31, 2026 | Breaking CHANGE | ready |
MainSubject | Q2 2026 |
| ready |
TextContent for reviews | Q1 2026 |
| ready |
MarketPublishingStatusNote | Jan 31, 2026 | Breaking CHANGE | ready |
MarketPublishingStatus | Jan 31, 2026 | Breaking CHANGE | ready |
EpubUsageLimit | Q1 2026 |
| ready |
EndDate | Q2 2026 |
|
|
Feature / change
Sales Restrictions Breaking CHANGE
Sales restrictions are expressed using codes from list 71, SalesRestrictionType.
In v2, existing use of SalesRestriction:
Code 00 Unspecified + SalesRestrictionNote indicates that the title is available for streaming services.
Code 12 Except to subscription services indicates that the title is not available for streaming services.
SalesOutlet and StartDate may be included as a part of SalesRestriction.
V3
Subscription service = in Onix, understood as the service provider, i.e. the organization providing streaming and / or subscription services to end customers.
A subscription service in Norway, must also offer single sales.
Sales outlets and start date will always be present in the sales restriction for subscription services.
One market may have one or multiple sales restrictions.
One sales restriction may have one or multiple outlets.
Bokbasen’s Inventory service will be deprecated, all necessary information will be found in the Sales restriction element.
If a publication is open for inclusion in a subscription service’s library, this is identified by code 20 from list 71. Code 20 = Except to some subscription services.
The use of code 12 is deprecated.
Available for streaming for one, multiple, or all subscription services from a given date (the same date for all sales outlets).
Also available for single sales for all subscription services.Available streaming for one, multiple or all designated subscription services from a given date, where the date is specified for each sales outlet.
Also available for single sales for the same subscription services.Not available for subscription services, single sales only.
Single sales provided both by retailers and subscription services.
The record will not contain the sales restrictions element.Subscription services only, not available as single sales (i.e. audio only).
Subscription services named in SalesOutlet, start date is specified as the same for all subscription services.Subscription services only, not available as single sales (i.e. audio only).
Subscription services named in SalesOutlet, start date is specified for each subscription services.Available as direct sale from publisher only
Available as direct sale from publisher and from designated retailers
The sales restrictions may change, and must be checked every time the metadata is updated.
SalesOutlet will be identified by codes from list 139.
NSBN and Bokbasen’s proprietary identifiers will be deprecated in the Sales outlet element.
Territory can use CountriesIncluded -OR- RegionsIncluded
So either: <CountriesIncluded>NO SE DK FI ...etc...</CountriesIncluded>
Or whole world except North Korea: <RegionsIncluded>WORLD</RegionsIncluded><CountriesExcluded>KP</CountriesExcluded>