Browse
Pages
- Overview of documentation
All the official documentation relating to Goobi has been produced by intranda GmbH. It is divided into three main areas, each with a different focus on the same application, and aimed respectively at... - What is Goobi?
Goobi is the most popular open-source workflow management software for use in digitisation projects. It covers the entire spectrum of tasks involved in the digitisation process – from book to online p... - Overview
... - Goobi for Users
Basically, Goobi is a web-based application. To a very large extent, the way it is used and operated will be familiar to you from numerous websites. On the user side, all you need to be able to use Go... - Logging in
To work with Goobi you will need a valid user name and password. You will usually receive these from your system administrator. In most case, they will be the same as those you were given for access t... - Menu
As is usually the case for web applications, you will find a navigation menu. After logging in, users can select from a number of options depending on their level of authorisation. The diagrams below ... - Logging out
For security reasons, you should always log out of Goobi whenever you leave your work station. Depending on the configuration, Goobi will automatically log you out after a period of inactivity. To log... - Switch between available languages
In the top right corner you can switch between several available languages. Goobi is supplied and installed by intranda in German, English and Spanish. Adding other languages is straightforward, and t... - Help function
Towards the right-hand edge of the menu bar there is an option to call the integrated Help function. This can be used for many of the input boxes in Goobi and shows you which information is required a... - Personal settings
Once you have logged in, you can choose a number of settings to create your own user profile. To do this, click on your user name in the menu bar and then on the sub-menu item User configuration. Goob... - Changing your password
As with any other technical system, you should change your password from time to time for security reasons. To do so, click on your user name in the menu bar and then select the Change password option... - My tasks
After logging in, most users continue with the menu option My tasks in the menu bar. This will display a screen similar to the one shown below: In the My tasks list, you will only find those process t... - Processes
All the processes that you or other users create will remain in Goobi’s database. To display an overview of these processes, select the option Workflow - Processes in the menu bar. Goobi will display ... - How to find a process
If you want to search for a particular process, you can use Goobi’s straightforward search box. To do so, select the Workflow - Search for volume option from the menu bar. The input box used to search... - How to create a new process
There is a specific screen for adding new processes to Goobi’s store of data. Select the option Workflow - Production templates from the menu bar. You will be shown a list containing all the productio... - Edit task details
On the page shown here, the details and plugins for tasks can be configured. The page does not differ significantly between tasks of process templates and those of existing processes. Differences are ... - The basics
Before we look in detail at the methodology of specific user groups, let us take a look at some basics. Any of the terms used in this section that may not be familiar to you can be found together with... - Scanning
The methods used by scan operators working with Goobi on a daily basis do not vary substantially from those of other users with different qualifications or responsibilities. All users must first log i... - Quality control
At many sites that work with Goobi, a manual check is made on the quality of the scanning work performed in earlier steps of the workflow. The methods used by the staff who conduct these quality check... - Manual script steps and plugin steps
In addition to the tasks we have already described, it is possible to configure Goobi so that users can call up any external programs, scripts or plugins for specific purposes from within Goobi. To th... - Automatic script-run steps
As well as the manual scripts described in the last section, Goobi can also be configured to execute individual workflow steps automatically if they have been configured to call up scripts. To do this... - Metadata processing
One of the main areas of work for those users with library training in the field of digitisation projects involves the comprehensive indexing of digitised objects. Basically, this covers pagination, s... - Export to the DMS
One of the workflow steps frequently included in a wide range of digitisation projects at numerous establishments involves making the digitised material available to the public together with the corre... - How different user groups work with Goobi
The next section examines some typical user groups in order to illustrate their structure as part of digitisation projects at numerous establishments and the way they work with Goobi on a daily basis.... - Structure tree
The grey-shaded area on the left of the screen contains the structure tree, where you can see in hierarchical form all the structure elements that have already been obtained from the source material. ... - Page display
The right-hand side of the Metadata Editor gives you an overview of the individual digital images that form part of the current process together with the number of pages, the current magnification lev... - Menu options
Goobi offers a wide range of functions that simplify the task of working with structure data and metadata. These options can be found in the top menu bar and at the right-hand edge of the structure tr... - User interface
Once you have opened the Metadata Editor, you have full access to all the editing options relating to the pagination, structure data and metadata of the digitised material. The Metadata Editor is divi... - Pagination
Pagination is a key element of digitisation projects. It involves matching page labels (printed page numbers in the source material) to the scanned images. In older works, the page numbering often cha... - Create new structure element
The list of elements from which you can select in the New structure element box will vary depending on which structure element has been activated. You can choose the position where you want to insert ... - Moving structure elements
There are several ways in which you can subsequently modify the structure of a document. One of these involves moving structure elements to a different position. To do this, first select the structure... - Copying structure elements from other processes
Within Goobi, it is also possible to copy structural elements from the METS file of a process to another process. To do this, click on the Import structural element from another process function in th... - Structuring
When you have completed the task of pagination, the next step in the workflow involves structuring. Working again in the Metadata Editor, the aim is to identify and record all the relevant structure e... - Metadata indexing
The main area of the Metadata Editor also contains a navigation bar to perform a range of steps during metadata indexing. Selecting Pagination, Structure data, Metadata and File replacement allows you... - Subsequent changes to pagination
If you wish, you can modify previously created pagination sequences. Goobi allows you to move or delete individual pages or several pages at the same time. To do this, you first need to select the req... - Uploading files
This function can be used to upload a file from the user’s computer to a selected process folder. The user will need to specify a file and choose the position within the pagination sequence where the ... - Downloading files
This function can be used to download a file from the current process folder to the user’s own computer. The user can select the file to be stored locally using the computer’s file browser.... - Server-based exports
A subfolder entitled fileupload is automatically generated on the Goobi server in the configured folder named tempfolder. This subfolder is used to exchange files between processes on the server. In t... - Server-based imports
Provided that the server-based target folder is not empty, you can use the Server-based import box to select a folder from which previously exported images can now be imported into the current process... - Modifying and verifying data
This section explains a number of additional functions in the METS Editor that involve directly modifying the file system for the images. For this reason you should take great care when using the func... - Edit OCR results
The metadata editor has an editor for OCR results with which the ALTO XML files in the process can be edited. This editor can be accessed via a button in the upper menu bar: The ALTO editor overlays t... - Overview of the keyboard combinations
There are various keyboard combinations available in the metadata editor. These are summarised here once again: | Keyboard combination | Description of function | | :--- | :--- | | Ctrl + Shift + Curs... - Metadata Editor
Goobi’s Metadata Editor is one of the core elements of digitisation projects. Most work involving the Metadata Editor is performed by trained librarians. There are two ways to open the Metadata Editor... - Users
... - Structure of the extended user interface
Goobi users with a higher level of authorisation will find a number of additional options in the menu bar. These allow you to amend data that may relate to an entire project or to different users and ... - Rulesets
One of the fundamental aspects of Goobi is that all structure data and metadata to be recorded as part of a digitisation project can be specified on the basis of a flexible system of rulesets. Before ... - LDAP groups
One of Goobi’s key features is the integration of both Goobi and the additional services linked to it to a central authentication system. In most cases, the authentication process is conducted via a c... - Users
In order to specify and manage the users that you want to be able to work with your Goobi installation, first select the menu item Administration - Users from the menu. This will display a list of all... - User groups
In order to ensure flexibility in the handling of freely configurable workflows and the corresponding users, you will need to define a number of user groups. These user groups can be understood as the... - Searching processes
If you want to search for specific processes, you can use Goobi’s extended search function. To do this, select the menu bar option Workflow – Search for volume. In order to conduct a finely tuned sear... - Activity
If you need even more detailed information about a process, click on the first symbol in the Actions column for that process. This will open the detailed view window for that process with a number of ... - Activities for hit lists
As well as the options described above allowing users to edit or amend each volume independently of the current status of the workflow and to process its structure data or metadata or re-export the da... - GoobiScript
When you apply an action to a group of processes, you also have an option to run Goobi scripts within that action. To do so, click on the button Execute GoobiScript in the Possible actions box. Goobi ... - Processes
All objects that are processed in Goobi as part of the whole range of digitisation workflows, and that as such have their own individual progress status, can be viewed in the Processes area. First, cl... - Variables
Goobi can also use variables when performing certain actions. Some of these variables can be used only in specific contexts, e.g. the variables {login} and {user full name} when configuring the LDAP. ... - Harvester
The harvester can be used to automatically import data from external repositories. Overview To be able to access the harvester, the user must have the Edit harvester repositories right. The Harvester ... - Config Editor
This editor allows direct editing of the Goobi workflow configuration files from within the user interface in the web browser. Overview The editor can be found as a separate entry in the Administratio... - Ruleset editor
This editor is used to directly edit the ruleset files of Goobi workflow directly from the user interface within the web browser. Übersicht The editor can be found in its own entry in the Administrati... - Management
... - ‘config’ sub-directory
The config directory contains all the Goobi configuration files that do not have to be located within the application itself. These are listed below: bash=configcontentServer.xml goobiactivemq.xml goo... - ‘import’ sub-directory
Depending on the way Goobi has been installed, the import directory will contain a range of data, mostly on a temporary basis. By way of example, import plug-ins use this directory to enter metadata a... - ‘metadata’ sub-directory
The metadata directory is the central directory for storing Goobi metadata and digital content. Within this directory there is a directory with the name of the Goobi process ID for each Goobi process.... - ‘plugins’ sub-directory
Depending on the way Goobi has been installed, the plugins directory may contain a number of plug-ins that perform imports or call Web API commands. Depending on the task, the compiled plug-ins are lo... - ‘rulesets’ sub-directory
Within Goobi, the UGH class library is used to process metadata, map PICA imports and generate METS files. In order to manage the huge variety of configuration options, UGH uses a mechanism known as r... - ‘scripts’ sub-directory
A range of scripts can be made available centrally in the scripts directory. These scripts can be used within the workflow to automate certain tasks.... - ‘xslt’ sub-directory
Goobi uses a mechanism called XSLT transformation to generate dockets as PDF files. This involves generating PDF documents from existing xml files. This is done on the basis of xslt files located cent... - Global directory structure
As a web-based application, Goobi has its own structure and is located on a defined path in the file system independently of the servlet container being used. This section explains how to organise the... - Directory structure of the application
The Goobi installation path may vary depending on your installation. Typically, the base path for web applications on an Ubuntu Linux system within an Apache Tomcat servlet container is shown below: b... - Integrating external storage
General Most digitisation projects involve handling very large volumes of data. In most cases, this makes it necessary to link external storage capacity to the server. This can be done in a number of ... - Integration of S3 as storage
Goobi workflow allows operation with S3-compatible storage. It should be noted that a local file system is still required to store the metadata. This means that the files meta.xml, metaanchor.xml and ... - File system
As a workflow management application for the library environment, Goobi has to be able to deal with a wide range of specific configurations and project-specific requirements. To this end, it has been ... - MySQL database
General Goobi saves information using a database. As a rule, the preferred option is MySQL. Ideally, the latest stable version of this database engine is installed from the operating system’s standard... - Apache Tomcat servlet container
General Goobi is a web-based Java application. The Java code needs to be translated to ensure that Goobi can be called from your web browser. This job is done by a servlet container. Some examples are... - User authentication using LDAP
General Goobi usually uses an LDAP server to authenticate users. This makes it possible to connect to the provided network drive with the same user name and password as in Goobi. In the configuration ... - File system access using Samba
General Goobi uses Samba to provide users with directory authorisations to read and write image data. The latest stable version of Samba should be installed from the operating system’s standard reposi... - Services
To let Goobi run several services are required as dependency. These services get explained on the following pages.... - Technical data
The following screenshot shows the Technical data tab from Goobi’s project settings: The configuration settings are explained below: List of project configuration parameters used to generate METS file... - Mets parameters
The following screenshot shows the Mets parameters tab from Goobi’s project settings: The configuration settings are explained below: List of METS parameters for use when configuring the project | Nam... - Mets file groups
In addition to the configuration parameters listed above, the METS file groups can also be specified. The screenshot shows five defined file groups: Min Max Thumbs Default Presentation The file groups... - Export configuration in the Goobi configuration file
A further export setting can be configured in goobiconfig.properties. The corresponding parameter is shown below: ini=goobiconfig.properties exportWithoutTimeLimit=true|false If this value is set to t... - Exporting to digital libraries
Goobi allows users to export processes (together with all their digitised objects) to digital libraries. As a rule, the XML file (METS) is exported last. It is generally preceded by any images, OCR re... - Working with the intranda Task Manager
Goobi communicates with the intranda Task Manager via the TaskClient. In Goobi, this command line program is configured as part of a workflow step. It can accept and process a number of parameters. Th... - Example combination for an automatic script task
In most cases, an automatic task is combined with a script task. Goobi then responds to the script output. Goobi will treat any messages issued on the default output console as simple status reports a... - Migration of technical data to METS files
Goobi automatically exports METS files to a pre-defined folder. This is usually the directory shown below: bash /opt/digiverso/viewer/hotfolder/ A sub-folder is created in this directory for each proc... - Automatic image deletion
Since version 1.9.2, Goobi has allowed users to fully automate workflow tasks using plug-ins, e.g. to delete images that are no longer required. This ImageDeletion plug-in should be the last step in t... - Automatic workflow steps
Goobi allows you to mark individual tasks as automatic. These tasks are opened and performed automatically once the preceding workflow task has been completed. Whenever an error occurs in such an auto... - goobi_activemq.xml
The goobiactivemq.xml configuration file specifies the settings for the org.apache.activemq Java library used by Goobi Workflow. Goobi Workflow does not use the file itself, but passes it directly to ... - goobi_config.properties
In the configuration file goobiconfig.properties, some fundamental settings are done for Goobi Workflow. The file is usually located at the following file system path: bash /opt/digiverso/goobi/config... - goobi_digitalCollections.xml
The configuration file goobidigitalCollections.xml is responsible for controlling the selection list of digital collections. It is usually located at the following path in the file system: bash /opt/d... - goobi_exportXml.xml
The goobiexportXml.xml file specifies technical details about the properties and associated XML namespaces used when generating docket files. The file is usually located at the following location: bas... - goobi_mail.xml
The configuration file goobimail.xml is used to configure mail dispatch for Goobi. The file is usually located here: bash /opt/digiverso/goobi/config/goobimail.xml For example, this configuration file... - goobi_metadataDisplayRules.xml
The goobimetadataDisplayRules.xml configuration file specifies how the metadata is to be displayed within Goobi's metadata editor. It is usually located at the following path in the file system. bash ... - goobi_normdata.xml
In the configuration file goobinormdata.xml links to databases are specified, which can be used for universal purposes. A main application is to obtain metadata to digitized objects. The file is usual... - goobi_opac.xml
The configuration file goobiopac.xml defines the communication between Goobi workflow and external data sources. This usually applies to systems such as library catalogs. The file is usually located a... - goobi_opacUmlaut.txt
In the configuration file goobiopacUmlaut.txt umlauts are specified which should be replaced when automatically generating process titles. The file is usually located at the following location: bash /... - goobi_processProperties.xml
In the configuration file goobiprocessProperties.xml further properties for projects, processes and steps can be specified. The file is usually located at the following memory path: bash /opt/digivers... - goobi_projects.xml
The file goobiprojects.xml configures the mask for creating processes. Here it is defined per project which metadata and properties are allowed for certain publication types. The file is usually locat... - goobi_rest.xml
In the goobirest.xml configuration file, the REST API endpoints used by Goobi Workflow are shared based on the respective path (as part of the URL). For each endpoint, the allowed HTTP methods and var... - goobi_webapi.xml
The goobiwebapi.xml configuration file is used to enable certain API endpoints of the Goobi Workflow Server for other servers or clients. The file is usually located at the following location: bash /o... - messages_xx.properties
In the translation files messagesxx.properties translations for texts in the user interface are specified. The xx mentioned here must be replaced by the corresponding language abbreviation depending o... - config_contentServer.xml
In the file configcontentServer.xml, technical details about the content server used in Goobi are provided. The configuration file can be used for Goobi Workflow and Goobi Viewer in the same way. The ... - goobi_configeditor.xml
The file goobiruleseteditor.xml specifies technical details for the config file editor. The file is usually located at the following location: bash /opt/digiverso/goobi/config/goobiconfigeditor.xml Fo... - goobi_ruleseteditor.xml
The file goobiruleseteditor.xml specifies technical details for the Ruleset editor. The file is usually located at the following location: bash /opt/digiverso/goobi/config/goobiruleseteditor.xml For e... - Configuration files
At various points, Goobi workflow is controlled via several configuration files. At this point, the most important configuration files are listed and explained in detail.... - Installation guide - Ubuntu 20.04
Introduction The following installation guide for Goobi workflow refers to Ubuntu Linux 20.04. It is written as a step-by-step guide from top to bottom, meaning that settings and configurations build ... - Installation guide - Ubuntu 24.04
Introduction The following installation guide for Goobi workflow refers to Ubuntu Linux 24.04. It is written as a step-by-step guide from top to bottom, meaning that settings and configurations build ... - Installation guide
Installation instructions for Goobi workflow are provided here. The following installation instructions are already available: [Ubuntu 20.04 (deprecated)](/en/workflow/manual/admin/installationguide/u... - Preparation of an update
General information When you update Goobi workflow, all plug-ins should also be updated. You should also check the page Installed plug-ins in Goobi workflow. If this page does not yet exist, the relev... - 2020
2020-09-17 In the ImageQA plugin, the configuration of the rotation and deletion commands has changed. These have to be adapted. This is the old configuration: xml /opt/digiverso/goobi/scripts/deleteI... - 2021
2021-12-16 The statistics plugin now exports XLSX instead of XLS, therefore the template file was changed. /opt/digiverso/goobi/plugins/statistics/statisticstemplate.xls needs to be replaced with http... - 2022
22.12 Config file change for the plugin Generic XML Import This point can be ignored if the plugin is not in use and thus the output of this command is empty: bash xmlstarlet sel -t -c '//catalogue/co... - 2023
23.10 Änderung der Konfigurationsdatei des Plugins goobipluginworkflowfileuploadprocesscreation The naming scheme has changed with the update. In the config file pluginintrandaworkflowfileUploadProces... - 2024
24.11 Artist Dictionary If the following plugins are used, manual steps must be carried out after the update: bash plugin-dashboard-entity plugin-export-luxembourg-artist-dictionary plugin-workflow-en... - 2025
25.08 Config update for the plugin goobi-plugin-step-mixed-ocr The callback URL for the Mixed OCR plugin changes from goobi/plugins to goobi/api/plugins. Example for the adjustment in pluginintrandast... - Update steps
The individual update steps that must be carried out to update a Goobi workflow installation to the required version are explained below. Please note that before carrying out the work documented here,... - Update guide
This section contains detailed documentation on how to carry out updates to Goobi workflow. An update should always be carried out in such a way that a backup of the important data is made beforehand.... - Authentication via the database
With database authentication, users are managed entirely by Goobi workflow itself. The user name and password are stored in the Goobi database. Within the database, only a hash (sha256 & salt) of the ... - Authentication via HTTP header
HTTP header authentication reads an HTTP header in the request and checks if there is a user whose SSO-ID matches the content of the header. If there is a user, he will be logged in. As HTTP headers c... - Authentication via OpenID Connect
OpenID Connect 1.0 is an authentication layer based on the OAuth 2.0 protocol. It enables clients to obtain the end user's identity from an authentication provider in a REST-like manner. Goobi workflo... - Authentication
Some of the typical authentication options offered by Goobi workflow are documented below. In addition to authentication using the user passwords stored in the database, you can also use LDAP, Active ... - Create thumbnails for accelerated image display
For some time now, it has been possible to create a thumbs/ folder in Goobi workflow process folders. In this folder, thumbnails for the images in the folders in the images/ folder can be stored. When... - Handling of 3D Objects
Instead of two-dimensional images, 3D objects can also be saved in the images folder and displayed in the Goobi interface. Goobi can display the following 3D formats: bash=.obj .ply .stl .fbx .gltf .g... - Use cases
In the following sections, some concrete application scenarios are explained in detail. Some of the configurations are customer-specific and may therefore not be transferable to all Goobi workflow ins... - Administration
... - Preparatory work
Installing the database server Goobi workflow uses the database MariaDB to manage data. This must be installed on the system accordingly. Installation on Linux Installation on Ubuntu Linux is carried ... - Download source code and demo data
Initial setup A script has been created to check out the source code and download it, which performs the following tasks: - Create a database if one does not already exist - Download the demo data - C... - Setting up the development environment
The setup of a development environment is described here for Eclipse and Visual Studio Code: Eclipse Installation - Eclipse can be downloaded from [here](https://www.eclipse.org/downloads/packages/rel... - Best practice for developing Goobi and working with Eclipse
1.4.1 Useful software packages In order to work with the repositories and source code in a meaningful way, additional packages should be installed. These have proven to be useful: Linux bash sudo apt ... - Development environment
For the development of Goobi workflow, we usually work with the Eclipse development environment or with Visual Studio Code. The following pages explain how to set up a development environment and impo... - Using the REST API
Goobi workflow has a very comprehensive REST API that can be used to connect external applications and services to Goobi workflow. Configuring the REST API This configuration of the REST API is alread... - Development
... - Manual
About this manual Welcome to the Goobi Manual. This is the official documentation produced by intranda GmbH as the core developer of the open-source workflow management application known as Goobi. The... - Documentation areas
The documentation for the Goobi viewer was created by intranda GmbH. It is divided into four different sections, each with a different focus on the same software. Configuration In the Configuration se... - About the Goobi viewer
The Goobi viewer is the central basis for your digital library. It handles the entire visualisation of your digital content. In order to provide you with a clear overview and a smooth use of the Goobi... - Overview
... - Local settings
Note The semicolon is a reserved delimiter character in the configuration file and must be explicitly masked with a backslash if necessary! The following files can be created in the [local configurati... - Translations
The majority of text elements in the Goobi viewer are available in multilingual messages.properties files. These individual text elements can be overwritten via local messages.properties files (one fi... - Folder configuration
The Goobi viewer contains various folder configurations, which are explained in more detail below xml=configviewer.xml /opt/digiverso/viewer/config/ /opt/digiverso/viewer/ /opt/digiverso/viewer/data... - URL configuration
The Goobi viewer offers the possibility of linking to external systems in several places. The parameters that are responsible for these links are explained here. xml=configviewer.xml https://viewer.ex... - Authentication Provider
Various providers are available for registration. These are configured in a list under : xml=configviewer.xml my first group my secondgroup The attributes in Elements have the following meaning: | Att... - Sending e-mails
For the registration of a local user account, as well as for other mail dispatch, a mail server must be configured. The configuration for this is as follows: xml=config_viewer.xml localhost do-not-rep... - Further settings
Regardless of the selected authentication type, the registration of new accounts or the reset password can be deactivated. The following switch is used for this purpose: xml=configviewer.xml A securit... - User accounts
The Goobi viewer has a user area that is only accessible after prior authentication. How to configure access to this area is described in the sub-chapters.... - Performance
The following setting allows you to specify the size (number of pages) of a record from which an alternative page loading mechanism is used to avoid memory overflows for very large records. The defaul... - Access conditions and images
If necessary, the display of images of some records can be blocked by means of an access licence. However, it may be desired to display small thumbnails of the images anyway. For this purpose, a maxim... - Captcha
To restrict the sending of automatic e-mails from bots via the feedback form, or when generating PDF documents externally, a Captcha query can be used. The reCaptcha service is integrated into the Goo... - Variants
Overview There are two versions of the PDF download: 1. Real-time generation, which directly triggers a download of the requested PDF during which the PDF itself is generated. 2. The external generati... - Download Links
PDF download links can be displayed in several places. These can be configured individually. xml=configviewer.xml false true true true false | Option | Description | | ---------------------- | -------... - Individual PDF title page
PDF documents created in the Goobi viewer can have additional upstream pages containing optional metadata on the complete record and on individual structure elements. The metadata is read exclusively ... - PDF download
PDF files can be generated for the entire work as well as for individual structural elements or images. The options are available in the widget "Cite and repurpose" or partially in the table of conten... - ePub download
Records for which OCR results are available in ABBYYXML or ALTO format can be downloaded as ePub. The prerequisite for this is the use of external PDF generation. The download links are provided analo... - Extended scrolling in the image view
In the image display, it is possible to adjust the navigation above the image. In addition to the usual scroll functions in the image display, additional buttons can be added by configuration to scrol... - Navigation between structure types
Via , structure types can be defined between which it is possible to navigate quickly in full screen mode (such as "next chapter or next figure"). For this, the attribute enabled="true" must be set. T... - Image view configuration
For the image display OpenSeadragon based on the IIIF Image API is used. A separate configuration block exists for the display, in the section. Goobi viewer installations using the crowdsourcing modul... - Maintaining zoom and rotation while browsing in the image view
Optionally, the last used zoom level and rotation of the image display can be retained when scrolling within a record. This then applies to all types of zoomed image display within a record and a user... - External images
External images are normally passed directly to the client in the image display. Sometimes, however, it makes sense to retrieve them from the intranda ContentServer and have them delivered by the Goob... - Restriction of image scaling
The intranda ContentServer, i.e. the component that loads the requested image data and delivers it to the Goobi viewer, has the ability to scale any image as desired. This is quite positive in theory.... - Thumbnail settings
The Goobi viewer offers the option of displaying all pages of a record in a preview view in the form of thumbnails. The following option specifies the maximum number of thumbnails that can be displaye... - Image Footer
An optional footer can be displayed below the image. The text it contains is configured as follows: xml=configviewer.xml SOLR:MDCOPYRIGHT urn purl The enabled attribute must be set to true for this fu... - Image options
This section explains the options available for restricting or manipulating the image display in the Goobi viewer. With the element, it is possible to add an additional CSS class to the #viewObject el... - Individual page types
In the URL schema of the Goobi viewer's links, there are fixed names for different page types. For example, the image display is always under /image/ and the search under /search/. To assign your own ... - Opening certain document types in alternative page views
It is possible to open certain document types in alternative page views. If, for example, newspapers and newspaper volumes should always be opened in the calendar view (instead of the image view), thi... - Full text hints
If a record contains only a few selected full-text pages, the search for them can be very difficult. This may be the case, for example, if only individual pages of a manuscript have been transcribed s... - Language settings
Formats for dates in different languages can be entered in the / area. If this area is missing, the standard formats specified in the code example are used. For each language for which a different for... - Themes
General If your Goobi viewer has been installed with its own theme, the corresponding name is contained in the following configuration element: xml=configviewer.xml The mainTheme attribute contains th... - Sorting
The sorting of the search hit list can be configured as follows: xml=configviewer.xml RANDOM RELEVANCE SORTCREATOR SORTTITLE SORTYEARPUBLISH\\;SORTTITLE !BOOLPRIORITIZE With the Attribute enabled the ... - Faceting
The search hits are automatically faceted. The configuration is as follows: xml=configviewer.xml YEAR WKTCOORDS DC DOCSTRCTTOP DOCSTRCTSUB MDCREATOR MDPLACEPUBLISH MDLOCATION MDOTHERVALUE MDTITLE MDLA... - Advanced search
There is an advanced search, where you can search specifically in individual metadata fields. In the first line, the search areas from the section are offered, see also chapter [1.17](./). Different t... - Timeline
The Goobi viewer offers an entry point to the content with the timeline. It can be configured in the following section: xml=config_viewer.xml 1500 2013 36 The attribute enabled switches the timeline o... - Calendar
A calendar is available for search entry. It lists all records that contain the field YEARMONTHDAY in the Solr search index. The calendar entry is activated with the following setting: xml=config_view... - Save search
Logged in users have the possibility to save search queries and retrieve them later. This functionality can be switched off with the following switch. The default value is true. xml=config_viewer.xml... - Expand query for search sub-results
With this switch, an expand query can be built for search sub-results from current faceting, even if no concrete search terms have been entered. For example, sub-elements of a record can also be liste... - Aggregated search hit display
The Goobi viewer lists records in the search hit list with associated subhits. The display of the sub hits can be further controlled. With the attribute enabled the sub hits can be switched on and off... - Versioning of records
If several versions of certain record exist, you can display a version history for the user in the sidebar. To do this, the records must contain the identifier of the predecessor or successor version ... - Exporting search results
Search results can be exported to an Excel file or in RIS format. The Excel export functions can be turned on and off with the enabled attribute. The fields that are transferred to the generated Excel... - Search hit metadata
xml true 1 40 For the metadata of the search results, there are the following configuration elements: | Setting | Description | | --------------------- | ----------------------------------------------... - Search
The search in the Goobi viewer allows a combined search both in the metadata and in the full texts. Depending on the selection, a search can also be restricted to the metadata or the full texts of the... - Collection hierarchy
A digital collection can contain several hierarchy levels of subcollections. Each record can belong to any number of collections. It is also not possible to belong to a collection. If a record is assi... - Sorting of records
If a collection has been opened, the records contained in it are listed in the standard sort (by relevance) for search hits. This sorting can be overridden individually for each collection, if require... - Sorting of collections
By default, your collections are sorted alphabetically by their names in the collection overview (that is, not by the names in messages.properties). However, it is possible to define your own sequence... - Blacklist
It sometimes happens that certain digital collections are already present in the Solr search index but should not yet be displayed. In this case, you can use the collection blacklist: xml=configviewer... - Collection size
The size of a collection is the number of records it contains. In the collection overview, this number is displayed in parentheses after the name of the individual hierarchy level of the collection. T... - Further settings
The following is a list of additional collection settings. xml=configviewer.xml -1 images/collections/collectiontiled_default.jpg true true | Setting | Description | | --------------------------------... - Structure element whitelist
By default, independent records and complete records (anchor) are delivered for search queries without specific search terms (such as collection listing, RSS generation, etc.). This is configured by t... - Digital collections
This section explains how to configure the collection listing.... - Main metadata
The main metadata are displayed on the "Bibliographic data" page. They can be configured as follows: xml=configviewer.xml 2019 MESSAGELICENCEINFORMATION Any number of elements can be defined. Each ele... - Sidebar metadata
The metadata in the sidebar must be distinguished between two display locations: 1. the display in full screen mode 2. the display within the record view When displayed in full screen mode, the metada... - Search hit metadata
The metadata for the search hits is configured in the same way as the main metadata. In addition, the optional separator attribute can be used to control whether multiple values should be displayed se... - Archive metadata
Metadata in the archive view is configured in the same way as the main metadata. The is available for this purpose: xml=configviewer.xml The sections marked with the type attribute have the following ... - Image metadata
Technical metadata can be indexed for images, for example from a corresponding MIX block within the METS file. This is always displayed for the current image in a separate ‘Technical metadata’ widget ... - Display of authority data
The configuration of authority data in the authority data popup can be configured in the following section: xml=configviewer.xml NORMIDENTIFIER NORMNAME NORMIDENTIFIER NORMNAME NORM_ALTNAME The templa... - Calendar structure elements
To ensure that a calendar view is also available for certain structure elements, these must be included in the following list: xml=config_viewer.xml newspaper... - Browsing
The Browse function makes it possible to get a list of the entire dataset over a certain metadata, for example the title or name of the author. If you click on a link, all values in the database will ... - Multilingual metadata
The Goobi viewer supports multilingual metadata. This is indicated by the suffix LANGXX in the index field, where XX must be replaced by the language abbreviation. Here is an example of a trilingual t... - Licenses
When new records are created in the backend, a list of licenses is available. This list can be configured in the following place: xml=config_viewer.xml Each license has a label and a URL. The label is... - Metadata
In this section, you will learn how to deal with metadata in detail.... - Main table of contents
The table of contents is configured in the section: xml=configviewer.xml 50 60 CURRENTNOSORT CURRENTNOSORT false true 10 GROUPIDSERIES GROUPIDCONVOLUTE PIPARENT false 20 | Setting | Description | | --... - Sidebar table of contents
The table of contents of the sidebar is configured as follows: xml=config_viewer.xml true true 60 false 2 0 | enabled | Display of this element (true/false) | | --------------------------- | ---------... - Download tables of content as PDF file
See chapter [1.9](../9/)... - Tables of contents
The Goobi viewer provides two views for displaying the logical document structure: the content view and the sidebar content view. The content view is a separate page, the sidebar content view is displ... - Tag clouds
Large amounts of data in the index can significantly reduce the speed of tag cloud generation. In such cases, it is possible to reduce the sample size for individual tag cloud fields. For this purpose... - Resolver
Records The Goobi viewer offers resolvers to open worecordsks via an identifier (PI), an URN or a custom identifier. | Name | URL | | -------------- | -------------------------------------------------... - Sidebar
The following elements switch links in the sidebar to the different types of record view on or off : xml=configviewer.xml (EXAMPLE.|HIDDEN.) cc.svg zero.svg rs-inc.svg | Option | Description | | --- |... - Navigation and display
The following elements switch different elements or functions of the Goobi viewer on or off: xml=config_viewer.xml true true true true true true 50 false true true true false false false false true | ... - RSS feed
The Goobi viewer offers the option of making the latest imports available in an RSS feed. In addition, an overview of the last five new entries can be displayed in the sidebar. The following section i... - Reading lists
The Goobi viewer has the functionality of the reading lists. Non-registered users can save records on a list within their session and send them by e-mail if required. Authenticated users can maintain ... - User comments
The comment functionality is completely configured via the backend.... - CMS
The CMS module of the Goobi viewer is configured in the element block . xml=config_viewer.xml 400 The parameters are explained in detail in the following table: | Setting | Description | | -----------... - Transkribus
The Goobi viewer is able to transfer records from METS documents to Transkribus for the purpose of handwriting recognition. Any user with a Transkribus account can log into the Goobi viewer and add th... - Original content
Your Goobi viewer offers you the option of making files on a record available as direct downloads. These can be, for example, original versions of Born-Digital documents. To do this, the folder for or... - Piwik/Matomo
With the help of Piwik/Matomo statistics about the visitors can be collected. This functionality is configured in the following section: xml=config_viewer.xml example.org/piwik/ 1 The parameters are e... - Sitelinks
For search engines, for example, an overview of the records exported after years is generated. The configuration is done in the element xml=config_viewer.xml YEAR ISWORK:true The sitelinks are availab... - JSON
Attention The API described here is outdated. We recommend switching to the REST API. General The Goobi viewer has the option of providing metadata and images for selected records in a JSON document v... - IIIF
The Goobi viewer implements the IIIF Presentation API in version 2.1.1. This is configured in the following block: xml=configviewer.xml MDTITLE MDCREATOR MDPURL Production/MDEVENTACTOR Use/MDEVENTACTO... - Authentication
Some REST commands require authentication via a token. The token is defined in the configuration file in the following section: xml=configviewer.xml 6326390c-b19f-11e8-a99c-08606e6a464a For authentica... - CORS
Whether CORS headers should be written can be defined in the following section: xml=config_viewer.xml * Attention This value is false by default because the CORS headers are usually written in the ups... - API
Two WebAPIs are available within the Goobi viewer. One delivers configurable fields as JSON, the other implements the IIIF Presentation API.... - OpenSearch
The OpenSearch standard is supported for a direct search in the Goobi viewer database. A name and description must be defined in the viewer section: xml=config_viewer.xml Goobi viewer Open source soft... - Embedding
The Goobi viewer automatically generates tags for [oEmbed](https://oembed.com/), [OpenGraph](http://ogp.me/) and [Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overvi... - Maps
The following block exists in the configuration file for maps used in the Goobi viewer xml=configviewer.xml mapsmarker1 maps_marker2 maps_marker3 maps_marker4 maps_marker5 maps_marker6 maps_marker7 MD... - Translations
For the configuration of the translation groups offered in the backend, the following block exists in the configuration file: xml=configviewer.xml DC ACCESSCONDITION BOOLIMAGEAVAILABLE FULLTEXTAVAILAB... - Archive
A separate area in the configuration file is available for configuring the display of archival material. The metadata is configured in the archive metadata list. See chapter [1.19.6](19/4.md). xml=con... - Campaigns
Within the campaigns, various options can be configured globally: xml=config_viewer.xml fixed 7 5 11.073397, 49.451993 mapbox The parameters are explained in detail in the following table: | Option | ... - Add content
For the configuration of the content contributing functionality, the following section exists in the configuration file: Note In addition to this configuration, it is also necessary to store a URL to ... - Usage figures
The Goobi viewer can automatically collect usage figures for individual data sets. The following can be collected: the absolute number of page views (each time a page of a work is called up) unique pa... - Config Editor
The Goobi viewer can provide access to your own configuration files via the backend. .xml and .properties files can be displayed. The following section within configviewer.xml can be used to configure... - Proxy
For outgoing connections, the Goobi viewer Core can optionally use a proxy server. xml=config_viewer.xml http://proxy.example.org 8080 127.0.0.1 The parameters are explained in the following table: | ... - ActiveMQ
There is a queue in the Goobi viewer for background tasks. ActiveMQ is used for this. The queue can be switched on and off with the following configuration. It is also possible to define the number of... - Developer
A separate page is available for developers in the backend under the URL /admin/developer/. A ZIP file with configuration settings for commissioning in a local development environment can be downloade... - External Ressources
The Goobi viewer can retrieve external content from Born Digital documents and process it live. This makes it possible to export only the metadata for Born Digital documents to the Goobi viewer and to... - Goobi viewer Core
In this section you will learn some basic details of the general configuration, how to set the corporate design, how to overwrite default configuration files and some more.... - Main configuration
The main configuration looks as follows by default: xml=configindexer.xml 1000 2048 http://localhost:8983/solr/collection1 http://localhost:808/viewer/ CHANGEME true false true 1 true true NORMIDENTIF... - Directories
For operation, a number of folders must be configured for the Goobi viewer Indexer from which files can be read or in which files can be stored. If certain folders do not exist, they are created autom... - Proxy
For outgoing connections, the Goobi viewer Indexer can optionally use a proxy server. xml=config_viewer.xml 127.0.0.1 The parameters are explained in the following table: | Option | Bedeutung | | ----... - Performance
The performance can be influenced by some parameters: xml=config_indexer.xml 10485760 157286400 false 4 true The parameters are explained in detail in the following table: | Setting | Description | | ... - Structure types
Structure types can be automatically replaced by others in the index, if desired. To do this, these structure elements are entered in the following configuration list: xml=configindexer.xml false Othe... - Metadata
Each metadata field to be used in the Goobi viewer must be configured in the Goobi viewer Indexer in the fields configuration element. The following schema is used for this: xml=configindexer.xml mets... - Starting and Exiting
A shell script has been set up on your machine for the Goobi viewer Indexer. Only this script should be used for starting and stopping. Starting the Indexer Use the following command to start the Goob... - Indexing records
In order to index a record, the desired XML file (for example in METS/MODS, LIDO or TEI format) must be saved in the [hotfolder](/en/viewer/manual/configuration/indexer/folders). A separate XML file i... - Updating individual page documents
In order to avoid unnecessary loads on the Solr index in connection with updates from crowdsourcing, which can also affect the performance of the Goobi viewer, it is possible to overwrite individual f... - Deleting records
To delete a record, a file with the name pattern .delete must be placed in the hotfolder \(for example PPN123456789.delete\). As soon as the file has been captured by the Goobi viewer indexer, the cor... - Solr scheme
General The Solr schema used by the Goobi viewer Indexer and Goobi viewer Core is located in the Git repository of the Goobi viewer Indexer: [Link to schema.xml from the Goobi viewers](https://github.... - Further settings
If more than one Goobi viewer Indexer process is installed on a server, both processes log to the same file. However, the file name can be adjusted via the environment variable LOGFILENAME. This is pr... - Goobi viewer Indexer
The Goobi viewer relies on Apache Solr to search metadata and full texts. To make new records known to the Goobi viewer, they must first be indexed. This task is performed by the Goobi viewer Indexer.... - Main Configuration
The main configuration is done in the following sections Section: identifyTags xml=configoai.xml OAI Frontend http://localhost:8080/viewer/oai/ support@intranda.com transient YYYY-MM-DDThh:mm:ssZ The ... - Dublin Core
xml=configoai.xml true 100 DC DOCSTRCT info:eu-repo/semantics/openAccess Depending on the structure type displayed, different configurations can be used here, analogous to the viewer metadata. The con... - Europeana
xml=configoai.xml true 100 MDACCESSCONDITIONCOPYRIGHT MDACCESSCONDITIONCOPYRIGHT Instutution XYZ https://www.example.org/rights https://www.example.org/rights DC DOCSTRCT The individual parameters at ... - METS
xml=configoai.xml true 10 /opt/digiverso/viewer/indexedmets/´ DC DOCSTRCT Note Only records that were available in METS/MODS format during indexing can be delivered as METS. | Setting | Description | ... - LIDO
xml=configoai.xml true 10 /opt/digiverso/viewer/indexedmets/ DC DOCSTRCT Note Only records that were available in LIDO format during indexing can be delivered as LIDO. | Setting | Description | | ----... - MARCXML
xml=config_oai.xml true 10 /opt/digiverso/viewer/oai/MODS2MARC21slim.xml DC DOCSTRCT Note Only records that were available in METS/MODS format during indexing can be delivered as MARCXML. | Setting | ... - Xepicur
xml=config_oai.xml true 100 Article urn:nbn:de:restricted:123- DC DOCSTRCT The parameters are explained in detail in the following table: | Setting | Description | | ----------------- | --------------... - Goobi viewer overview pages
xml=configoai.xml true 100 The parameters are explained in detail in the following table: | Setting | Description | | ---------------- | ---------------------------------------------------------------... - Goobi viewer crowdsourcing
xml=configoai.xml true 100 The parameters are explained in detail in the following table: | Setting | Description | | ---------------- | ---------------------------------------------------------------... - TEI
xml=config_oai.xml true 10 LANGUAGE The parameters are explained in detail in the following table: | Setting | Description | | ----------------------------- | -----------------------------------------... - CMDI
xml=config_oai.xml true 10 LANGUAGE The parameters are explained in detail in the following table: | Setting | Description | | ----------------------------- | -----------------------------------------... - Sets
It is possible to define your own sets using a Solr query. xml=config_oai.xml DC A set always consists of setName, setSpec and setQuery. setName is a label for the set. This value is also displayed in... - OAI interface
... - SRU interface
The Goobi viewer has an SRU interface. This can be found at the following URL \(change base URL accordingly\): text https://viewer.example.org/viewer/sru Configuration of the interface is not possible... - Goobi viewer Connector
The Goobi viewer has an OAI and an SRU interface. Their configuration is described in the following sub-chapters.... - Configuration
... - Series and convolutes
General The Goobi viewer can depict groups of several independent records of art - regardless of the overall record and collection to which they belong - and present them as a logical, navigable unit.... - Access restrictions
General The Goobi viewer can interpret access restrictions. For this, they must exist as metadata. The following application scenario describes how to capture and configure an access licence using a m... - Subthemes
This section shows you how to use subthemes in the Goobi viewer. Goobi workflow A new metadata ViewerSubTheme must be added to the ruleset. This is then also added to DocStructs that have the CatalogI... - Authority data
Goobi workflow In the rule set, the attribute normdata="true" must be activated for the desired metadata so that the norm data can be entered in the metadata editor: xml=ruleset.xml Author Autor Autho... - Multilingualism
The Goobi viewer Core is available in German, English, Spanish, French and Arabic. If available, the interface is automatically displayed in the language that the browser has defined as the default la... - Maps
General The Goobi viewer supports the display of coordinates on a map. There are different possibilities for the acquisition, the indexing and the display. These are listed on this page. Acquisition a... - Sub collections
General The Goobi viewer can display digital collections with a hierarchy. The functionality is described in chapter [Collection hierarchy](/de/viewer/manual/configuration/core/collections/subcollecti... - Multiple Goobi viewer
General If two or more Goobi viewer instances are to be supplied from one Goobi workflow, various requirements must be met. This section describes how to configure common questions for Goobi workflow ... - Crowdsourcing module
The configuration file configviewer-module-crowdsourcing.xml is located in the local configuration folder next to the other configuration files. The path to it is defined in configviewer.xml and must ... - Archival documents
General The Goobi viewer can display an archive record in a tree view. If a record is linked to an archive, a widget is also displayed in the record view that shows the record in the archives hierarch... - Solr Queries
General Again and again the backend of the Goobi viewer refers to the necessity of formulating solr queries when it comes to providing a functionality only for certain records. This page will answer s... - Linking from METS file groups
General The Goobi viewer is often used in combination with Goobi workflow. In the Goobi workflow project configuration, various so-called METS file groups can be configured. The file groups then conta... - Add content
If active, users can contribute their own content. The Goobi viewer provides an upload form that can be used to create a process within Goobi workflow. The status of the process is checked regularly a... - Shibboleth
General The implementation of authentication is basically similar in Goobi viewer and Goobi workflow. Nevertheless, there are the following differences: In Goobi workflow the entire application is sec... - Access restricted metadata
General From version 24.12, the Goobi viewer also supports access-restricted metadata within a METS/MODS file. To configure this from start to finish, it is documented here as a use case. Goobi workfl... - Use cases
In the following sections, some concrete application scenarios are explained in detail. Some of the configurations are customer-specific and may therefore not be transferable to the entire Goobi viewe... - FAQ
How old is my Goobi viewer? In the source code of the page there are various meta tags at the very beginning, which provide information about the age and code base of the version used: xml "Goobi view... - Glossary
A Adminbackend The admin backend describes an interface through which parts of the content and functionality of the Goobi viewer can be controlled web-based. The interface is only available to user ac... - Miscellaneous
... - 2025
This page is currently only available in the German documentation.... - 2024
This page is currently only available in the German documentation.... - 2023
This page is currently only available in the German documentation.... - 2022
This page is currently only available in the German documentation.... - 2021
This page is currently only available in the German documentation.... - 2020
This page is currently only available in the German documentation.... - 2019
This page is currently only available in the German documentation.... - 2018
This page is currently only available in the German documentation.... - Core Changelog
This page is currently only available in the German documentation.... - 2025
General The files affected by changes are usually visualized as a task list and begin with the theme name. In this guide, boilerplate/ is used as an example and must be adjusted to match the correspon... - Theme Changelog
The following subpages list - in chronological order and organised by release - the points that need to be checked, adapted and implemented when updating Goobi viewer from a web designer's perspective... - Classical
Introduction The following installation guide for the Goobi viewer refers to Ubuntu Linux 24.04. It is written as a step-by-step guide from top to bottom, meaning that settings and configurations buil... - Docker
Introduction The following installation guide for the Goobi viewer refers to Ubuntu Linux 20.04. It is written as a step-by-step guide from top to bottom, meaning that settings and configurations buil... - Installation guide
... - Preparatory work
Installing the database server Goobi viewer uses the database MariaDB to manage data. This must be installed on the system accordingly. Installation on Linux Installation on Ubuntu Linux is carried ou... - Download source code and demo data
Initial setup A script has been created to check out the source code and download it, which performs the following tasks: - Create a database if one does not already exist - Download the demo data - C... - Setting up the development environment
The setup of a development environment is described here for Eclipse, IntelliJ and Visual Studio Code. Build tooling (Gulp, Grunt, etc.) is documented under [Build tools](../04buildtools/). Eclipse In... - Gulp build process
Overview This page describes the Gulp-based build process in the Goobi viewer. The goobi-viewer-core-config repository, every theme repository, and the core repository each ship their own Gulpfile.js.... - Grunt build notes
Overview Older Goobi viewer releases use Grunt to build and mirror front-end assets. The goal matches the modern Gulp workflow: keep configuration files in sync, compile CSS/JS bundles, and copy resul... - Best Practice & Troubleshooting
Adjust circular dependencies To prevent errors from occurring when building the Goobi viewer, the following setting must be made. Preferences Java Compiler Building Build path problems Circular depend... - Obsolete development environment from 2022
This page is currently only available in the German documentation.... - Development environment
For the development of the Goobi viewer, we usually work with the Eclipse development environment or with Visual Studio Code. The following pages explain how to set up a development environment and im... - API
JavaDoc With each release, Javadoc is automatically generated and published on Github pages. The documentation is available at the following URL: [https://intranda.github.io/goobi-viewer-core/index.ht... - File structure
This page is currently only available in the German documentation.... - Contents of the files
This page is currently only available in the German documentation.... - Contents types
This page is currently only available in the German documentation.... - CMS templates
The Goobi viewer has CMS functionality. This is based on the prior creation of freely configurable templates, which can then be used as often as required within the CMS area.... - Overwrite standard XHTML pages with your own customised pages
This page is currently only available in the German documentation.... - Theme conversion to Maven
This page is currently only available in the German documentation.... - Release creation
This page is currently only available in the German documentation.... - Theme adaptions
Inserting customised graphics for the image controls The graphics for the image controls in the object and full screen view can be replaced for a customised design in the theme. To do this, the .svg f... - Java
This page is currently only available in the German documentation.... - CSS and Javascript
This page is currently only available in the German documentation.... - Tests
This page is currently only available in the German documentation.... - Updates of dependencies
The following pages describe how to manage and update Goobi viewer dependencies.... - Explained!
This section contains instructions and explanations for developers and administrators.... - Devs & Ops
... - Manual
About this manual The Goobi viewer documentation consists of several parts. The configuration options of the Core, Indexer and Connector components are described in detail. In addition, parts of the a...