Skip to main content

Audiobooks Specific Metadata

Virginie Bouilhac
Updated

For Audiobooks, specific metadata have to be added to your metadata feed.

 

Table of Content 

Product Form

AudioBook Edition

Contributor Type

Duration

File Size

 

Product Form

--> Required Field - Based on Code List 150 (ONIX 3.0 - Code list 7 in ONIX 2.1) - If <ProductForm> begins with 'A', metadata.format will be automatically recognised as AUDIO.

Should be informed within the <DescriptiveDetail> composite.

Correct Usage (example)

Info Excel ONIX 2.1 and 3.0
Reference Name Detected by use of the Audiobooks template 
<ProductForm>AJ</ProductForm>
Short Tag N/A 
<b012>AJ</b012>

 

AudioBook Edition

--> Required Field. The Edition of your audiobook (Abridged or unabridged version). For unabridged, indicate UBR, for abridged, indicate ABR.
Because many audiobooks are abridged, it’s important to ensure the consumer knows what they are buying. So it’s always best practice to state whether it’s abridged or unabridged.

Should be informed within the <DescriptiveDetail> composite.

Info Excel ONIX 2.1 ONIX 3.0
Reference Name Audiobook Edition col. C of the Template

<EditionTypeCode>UBR</EditionTypeCode>

or
<EditionTypeCode>ABR</EditionTypeCode>

<EditionType>UBR</EditionType>

or 
<EditionType>ABR</EditionType>
Short Tag N/A   <b056>UBR</b056> or <b056>ABR</b056> <x419>UBR</x419> or <x419>ABR</x419>

 

Contributor Type

--> Required Field.
Add explicit support for:

  • E07 Reader
  • E03 Narrator
  • E08 Performed by
  • E09 Speaker Of a speech

Base on EDItEUR Code list 17

Correct Usage (example)

Info Excel ONIX 2.1 and 3.0
Reference Name Contributor Type col. T of the template
3 contributors max. 
<ContributorRole>E03</ContributorRole>
Short Tag N/A   
<b035>E03</b035>

 

Duration

--> Strongly recommended.
Parse the duration extent for time-duration information. Store both the ONIX values and the value normalized to seconds.

Base on EDItEUR
Code list 23 - <ExtentType> code 09 = Duration.
Code list 24 - <ExtentUnit> minutes; hours ; seconds etc… Only codes 04, 05, 06, 14, 15 and 16 are supported by Kobo as ExtentUnit values for duration extent. Other values will be ignored:

Value is supported by Kobo Description
2 No Words (will Fail ingestion for Audiobooks metadata)
3 No Pages (will Fail ingestion for Audiobooks metadata)
4 Yes Hours (integer and decimals)
5 Yes Minutes (integer and decimals)
6 Yes Seconds (integer only)
11 No Words (will be ignored)
14 Yes Hours HHH
15 Yes Hours and minutes HHHMM
16 Yes Hours minutes seconds HHHMMSS
17 Yes Bytes
18 Yes Kbytes
19 Yes Mbytes

 

Correct Usage (example)

Info Excel ONIX 2.1 and 3.0
Reference Name N/A 
<Extent>
<ExtentType>09</ExtentType>
<ExtentValue>457</ExtentValue>
<ExtentUnit>05</ExtentUnit>
</Extent>
Short Tag N/A   
<extent>
<b218>09</218>
<b219>0073600</b219>
<b220>16</b220>
</extent>

Filesize

--> Strongly recommended.
Parse the size extent for file-size information. Store both the ONIX values and the value normalized to bytes

Information is stored in Rakuten Kobo system, but is not used.

Based on EDItEUR
Code list 23 - <ExtentType> code 22 = FileSize.

Correct Usage (example)

Info Excel ONIX 2.1 and 3.0
Reference Name N/A 
<Extent>
<ExtentType>22</ExtentType>
<ExtentValue>500</ExtentValue>
<ExtentUnit>19</ExtentUnit>
</Extent>
Short Tag N/A   
<extent>
<b218>22</218>
<b219>500</b219>
<b220>19</b220>
</extent>

 

 

 

 

 

 

 

Related articles