koha-auth - Generate authorities from bibliographic records


version 0.071


With this script, it's possible to extract authorities from Koha bibliographic records, load them into the authorities table, and link authorities to biblios.


koha-auth create_from_biblio auth.conf authorities.txt

Creates a text file authorities.txt containing authorities extracted from Koha biblio records using auth.conf authorities configuration.

koha-auth [--truncate] [--doit] load_from_file auth.conf authorities.txt

Load authorities from authorities.txt into Koha using auth.conf authorities configuration. With --truncate, auth_head Koha table is truncated before loading new authorities. After this processing, authorities have to be indexed with Zebra in order to be searchable. Without --doit, the file processing is done but authorities are not effectively loaded into Koha DB.

Link biblio records fields with authorities via $9 subfield. Authorities must have been indexed with Zebra. After this processing, it is necessary to index bibliographic records with Zebra. Without --doit, the processing is done, but biblio records are not modified. This way you can check that authority heading matching works properly.


Authorities configuration file looks like that:

 authcode: NP
 authletters: abcd
 authtag: 200
 ind1: null
 ind2: 3
   - 700
   - 701
   - 702
 authcode: CO
 authletters: abcd
 authtag: 210
   - 710
   - 711
   - 712

Two sample configuration files are provided with this distribution and can be found in the dist local directory: auth-marc21.conf and auth-unimarc.conf.


Frédéric Demians <>


This software is Copyright (c) 2022 by Fréderic Démians.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007