Maximize your content’s visibility and sales on Snapplify with accurate CSV metadata. Follow our easy guidelines to ensure your file is error-free. Download our sample CSV, ensure correct column headings, and set your pricing with or without VAT as per your agreement.


Download the Snapplify metadata CSV sample.


The pricing provided in your metadata must either be inclusive or exclusive of VAT (sales tax), based on what has been agreed in your distribution agreement.



Understanding CSV metadata fields


The table below describes the column headings required for the CSV file. Each field below the column header must be completed.


Column heading

Description

Example

Required

EAN

The most important field is the EAN field. This is the digital ISBN of your book and its unique identifier.

No two ebooks can have the same EAN/ISBN.


The value in this field must match the corresponding asset file and jacket image file exactly:


9780801448157.epub

9780801448157.jpg

Correct: 9780801448157

Incorrect: 978-808-1448-157 978 808 1448 157 

Y
relatedEANThe print or hardcopy ISBN of the ebook.
The ISBN for the digital and hardcopy versions cannot be the same.
Correct: 978080144852

Incorrect: 978-808-1448-157 978 808 1448 852
N

File_type

The format of the file associated with this product

epub
pdf
snap
mp3
mp4

Y

Title

The title of the product

Where Licence_Days is not perpetual (forever), add the licence period to end of the title

The Lord of the Rings

 

The Lord of the Rings (1-year licence)

Y

Description

The description of the product. If you want line breaks in this field please use this sequence:  <br>

The Lord of the Rings is an epic high-fantasy novel written by English author J. R. R. Tolkien. 

N

Published

Whether this book is available immediately for sale

true/false

Y

Embargo_date

Date from which the book may only be sold by, in the format YYYYMMDD. This may be left blank if the book is immediately available for sale

20190123

N

Category

Top-level category/descriptor

Fantasy

N

Authors

Semicolon-separated list of authors in the sequence of First name Last name

Correct: JRR Tolkien; Bob Smith

Incorrect: Tolkien, JRR; Smith Bob

N

Edition

The product edition

1st, First, Revised, etc

N

Publisher

The publisher of the product

Oxford University Press

N

Publication_date

The date the product was first published, in the format YYYYMMDD

20190123

N

Pages

Page extent

264

N

Copyright

The copyright holder

Bob Smith, Oxford University Press, etc

N

Language

ISO language code of the product

Eng

(Find language codes)

N

Price

Price of product. This price should either be inclusive or exclusive of VAT (sales tax), based on what was contractually agreed in your distribution agreement. 

99.99

Y

Currency

The currency of the value provided in the price column. Ensure that the currency code is entered for each asset.                    

ZAR
(Find currency codes)

Y

Business_model

This determines the business model (rights) under which the titles are supplied and the associated pricing.

If a title is offered under multiple models, a separate metadata record (row) is required for each model. For example:

  • For both Retail and Library rights, provide two rows per title.

  • If selling via Origin, include a row with DIRECT_ONLY specified.
  • For distribution through Bookbuddy AI, include a row labeled AI.
  • For Open Educational Resources (OER) or other free content, include a row labeled OER.

So, if you have 50 titles available under both Retail and Library rights, and also available via Bookbuddy AI, you’ll need 150 metadata rows in total (3 per title).

RETAIL

LIBRARY


DIRECT_ONLY


AI


OER

Y

Allowed_countries

Semicolon-separated two-character ISO country codes where the book may be sold. 

If this field is populated, 

disallowed_countries must be left empty.

NB: Only valid country codes or leave blank if the book may be sold world-wide

ZA;US

(Find country codes)

N

Disallowed_countries

Semicolon-separated two-character ISO country codes where the book may not be sold. 

If this field is populated, Allowed_countries must be left empty.

NB: Only valid country codes or leave blank if the book may be sold world-wide 

AU;NG
(Find country codes)

N

DRM_required

Should DRM be applied to this product?

TRUE if the File Type is PDF, EPUB, or SNAP.

FALSE if the File Type is Audio or Video.

Find out more about how DRM works for publishers

true/false

Y

Number_of_devices

The number of devices/times the user may request a licence, if DRM_required=true


Find out more about how device limits work.

5

N

Licence_days

The number of days that the customer will be entitled to access the ebook. 


Suggest days:
Perpetual = leave field blank
1 year = 425
2 years = 790
3 years = 1155


If the licence is perpetual (forever) – leave field blank.


Find out more about how licences work.

425

N
PrintableSpecifies whether the PDF asset can or cannot be printed. Other file types cannot be printed.

Find out how to enable the printing of your content.
true/false
N

 

For ebooks used in educational institutions, in particular, we recommend 425 days for a one-year licence, 790 days for a two-year licence, and 1155 days for a three-year licence. This enables students and educators to purchase books for the following year and still have access for the full upcoming academic year (rather than losing access a month or two before that academic year ends).



Need help? Reach out to us by emailing marketplace@snapplify.com.