This article explains how to refresh a publisher's full dataset in TitlePage using a Complete Reload or Record Reset. Both methods are supported in ONIX 3.1, ONIX 3.0, and ONIX 2.1.
Who this is for
This article is for users responsible for managing the data feeds for publishers or distributors who upload ONIX files to TitlePage and want to:
- Reload their data.
- Delete orphaned products.
TitlePage provides additional functionality that allows a publisher's entire catalogue to be brought up to date in a single file load. This can be done using either a Complete Reload or a Record Reset, depending on your workflow and data structure. For the other ways to update or remove titles, see ONIX Update Workflows.
Complete Reload
A Complete Reload is the simplest way to ensure that all titles listed in TitlePage are correct and that no inactive or obsolete records remain in the system.
When a Complete Reload file is received, TitlePage:
- Compares all ISBNs in the file with those currently stored in the TitlePage database for that publisher.
- Checks each existing record for changes and updates them as needed.
- Creates new records for any titles not already in the system.
- Deletes any records in TitlePage that are not included in the file.
This means the file becomes the full source of truth for that publisher's catalogue. Any title you omit will be removed, so check the file covers your entire active list before sending it.
To trigger a Complete Reload, add the following element inside the <Header> of the ONIX file:
<MessageNote>Complete Reload</MessageNote>
Record Reset
A Record Reset is designed for workflows where the full record is split across multiple sources, such as publisher and distributor feeds, and a single complete file cannot be provided. It can also be used when a faster refresh is required.
When a Record Reset file is received, TitlePage:
- Compares the ISBNs in the file with those in the TitlePage database.
- Deletes any records that are not included in the Record Reset file.
- Supports partial updates using block updates, blocks 1 to 5 or block 6. See Block updates.
To trigger a Record Reset, add the following element inside the <Header> of the ONIX file:
<MessageNote>Record Reset</MessageNote>
Related articles
- ONIX Update Workflows, an overview of all the ways to update your catalogue
- Block updates, how to format a block update file
- Deleting Titles, removing individual products rather than reloading
- TitlePage ONIX Validation, checking the load report afterwards
Further information
For further information please contact TitlePage support.