Trillium R1 2026 Changes and required actions

Trillium R1 2026 Changes and required actions

Functional Area

Change or Additions

Considerations

Action timing,
Action required

Comments

Contact person,
Related JIRAs

Functional Area

Change or Additions

Considerations

Action timing,
Action required

Comments

Contact person,
Related JIRAs

mod-search

instance, instance_classification index mapping changes

 

After upgrade.

Reindex is needed. Upload reindex of instances, classifications is sufficient.

Use /search/index/instance-records/reindex/upload with body:

{ "entityTypes": [ "instance", "classification" ] }

 

@Viacheslav Kolesnyk
@Pavlo Smahin

https://folio-org.atlassian.net/browse/MSEARCH-1045

https://folio-org.atlassian.net/browse/MSEARCH-1067

@Khalilah Gambrell

@Christine Schultz

mod-inventory-storage

The breaking change was introduced for endpoints that do create/update item operations.
The itemLevelCallNumberTypeId property can now be only a UUID that exists in the call_number_type table.

Updated API versions

  • item-storage 11.0

  • item-storage-batch-sync 2.0

  • item-storage-batch-sync-unsafe 2.0

 

No specific action needed, migration is performing during module upgrade

 

@Pavlo Smahin
https://folio-org.atlassian.net/browse/MODINVSTOR-987

mod-reporting

When reports are invoked from a GitHub or GitLab repository, they are now checked against a whitelist included in the top-level configuration file under the key reportUrlWhitelist.

Reports whose URLs do not match one of the whitelist entries will be refused for security reasons.

Each installation’s whitelist should be configured appropriately by updating the config.json file (see the README file). Note that, if using the stock Docker container image, you will need to mount your copy of the file over the default.

If the default configuration is blindly used, previously working reports will stop working.

https://folio-org.atlassian.net/browse/MODREP-4

mod-circulation

New boolean environment variable ENABLE_FOR_USE_AT_LOCATION; defaults to false

To allow a single tenants items to be only circulated as items only For use at location (Reading room loans). The functionality require the loan policy, the service point setting, and the circulationrules to be set up to support For use at location functionality. If the library do For use at location loans, then the environment variable must be present and set to true

The variable can be set at any time.

 

@Charlotte Whitt @Niels Erik Nielsen

https://folio-org.atlassian.net/browse/CIRC-2457

mod-source-record-manager

The default MARC-to-Instance mapping rules have been updated for the 338 field (Instance Format).

 

Migration is performed during the module upgrade process. Ensure that it is successful; otherwise, perform a manual upgrade. Refer to the details for further instructions.

 

@Kateryna Senchenko

https://folio-org.atlassian.net/browse/MODDICORE-456

mod-entities-links

scope for authority expiration settings changed from authority-storage to authority-storage.manage

mod-settings will have 2 entries for authority-archives-expiration key, 1 with old scope and 1 with new scope. Only entry with new scope will be used by mod-entities-links.

In case this setting was modified by the users - they’ll need to modify a new one. Old setting entry may be removed since it will no longer be used.

Scope was changed to support eureka permission name pattern.

 

Note: We know for sure that LOC modified this value to never delete authority records.

@Viacheslav Kolesnyk @Christine Schultz

mod-specifications

Change API default to false for the following endpoints

  • PATCH /specification-storage/specifications/{MARC bib or authority specificationId}/rules/{global rule id for rule name "Undefined Field"}

  • PATCH /specification-storage/specifications/{MARC bib or authority specificationId}/rules/{global rule id for rule name "Undefined Subfield"}

  • PATCH /specification-storage/specifications/{MARC bib or authority specificationId}/rules/{global rule id for rule name "Undefined Indicator Code"}

This is a global change.

 

This is a global change and if a library wants catalogers to be warned of undefined fields/indicators/subfields then they will need to change these endpoints to true.

https://folio-org.atlassian.net/browse/MRSPECS-102

@Khalilah Gambrell

mod-specifications

MARC Specifications Update: Add new subfields and update existing subfields (Bibliographic & Authority) based on latest MARC Standards

Execution is optional and applicable only for libraries using MARC validation in Ramsons/Sunflower.

After upgrade.
Execute script to create new subfields and update existing subfields in MARC bibliographic and authority specifications based on the latest MARC standards documentation.
https://folio-org.atlassian.net/wiki/spaces/FOLIJET/pages/1904017417

Execution of this script is optional and it should be run only if the library has enabled MARC bibliographic or MARC authority record validation in Ramsons/Sunflower.
Before running the script, libraries should confirm they are comfortable with potential impacts on local validation rules. More details about the impact on local validation rules are available on the script page.

@Svitlana Kovalova
@Khalilah Gambrell

https://folio-org.atlassian.net/browse/MRSPECS-201

ui-tags/Settings - Tags

The "Enables tags" flag in Settings -> Tags -> General has changed its endpoint.

 

After upgrade. If this flag was turned off in your environment before the upgrade, you need to turn it off manually again.

The endpoint change means previous settings will not persist during upgrade.

@Dmytro Melnyshyn @Stephanie Buck

https://folio-org.atlassian.net/browse/UITAG-96

mod-users

The endpoint for preventing specific users from being edited or deleted (suppressEdit) has moved from the old configurations/entries endpoint to the new user/settings endpoint

Administrators need to migrate existing suppressEdit configurations to the new endpoint.

After upgrade. Migrate suppressEdit configurations using the new /user/settings endpoint with scope "mod-users" and key "suppressEdit". Examples: POST /user/settings { "scope": "mod-users", "key": "suppressEdit", "value": ["c62ec6db-99d9-5430-a61f-9cb639789795"] } PUT /user/settings/{id} { "id": "f7e03d17-3617-41da-bc80-5ec0d65ece25", "scope": "mod-users", "key": "suppressEdit", "value": [...], "_version": 1 } GET /user/settings/?query=(key=="suppressEdit")

Migration is required if suppressEdit was configured. This setting prevents designated users from accidental editing or deletion.

@Dmytro Melnyshyn @Stephanie Buck https://folio-org.atlassian.net/browse/UIU-3404

mod-users

The endpoint for configuring a user profile-picture functionality has been moved from /users/configurations/entryto /user/settings

The existing configuration which is accessed and managed with /users/configurations/entryendpoints will be migrated automatically with the first usage of any CRUD /users/profile-picture or POST /users/profile-picture/cleanup endpoints and then it’s no longer possible to access it with /users/configurations/entryendpoint

 

Instructions for manually creating the profile-picture configuration through POST /users/profile-picturecan be found here.

@Mukhiddin Yusupov

@Stephanie Buck
MODUSERS-554

mod-settings

New API to set UI URL

Call PUT /base-url when adding a new tenant or changing the UI URL of a tenant

After upgrade.

Formerly known as FOLIO_HOST

@Julian Ladisch

https://folio-org.atlassian.net/browse/MODSET-39
https://folio-org.atlassian.net/browse/MODSET-40

mod-entities-links

Authority propagated data cleanup in consortium Member tenants

Cleanup of duplicate instance–authority links and authority shadow copies in member tenants.

After upgrade.
Execute script to cleanup the authority propagated data (duplicate links, authority shadow copies) from consortium Member tenants https://folio-org.atlassian.net/wiki/spaces/FOLIJET/pages/1758724097

Only in consortium environment for a member tenant

https://folio-org.atlassian.net/browse/MODELINKS-388
@Svitlana Kovalova
@Pavlo Smahin

mod-gobi

Standard database connection environment variables must be added to the module configuration.

The migration of existing mappings to the new config_data table will be executed automatically.

Before upgrade when specifying env variables for mod-gobi

A new config_data table has been introduced to the database schema to store custom GOBI mappings.

https://folio-org.atlassian.net/browse/MODGOBI-217

@Serhii_Nosko

mod-inventory-storage

Item records now have property order

To populate the field for all item records there is a need to execute for each tenant background async migration itemOrderMigration using API https://s3.amazonaws.com/foliodocs/api/mod-inventory-storage/r/async-migration.html

After upgrade.

Performance test result could be reviewed: https://folio-org.atlassian.net/wiki/spaces/FOLIJET/pages/1864302598

@Pavlo Smahin

mod-agreements

New boolean environment variable ACCESSCONTROL_ACQUNITS_ENABLED defaults to true

Using acquisition units (from mod-orders - see https://docs.folio.org/docs/settings/settings_acquisition_units/settings_acquisition_units/) to control access to specific Agreements/Agreement lines has an impact on performance as it means extra lookups each time a user interacts with the agreement/agreement line to look up their access based on Acquisition Units.

If a tenant does not wish to use Acqusition Units for Agreements, this variable can be set to false

After upgrade

 

@Owen Stephens

https://folio-org.atlassian.net/browse/UXPROD-5188

mod-licenses

New boolean environment variable ACCESSCONTROL_ACQUNITS_ENABLED defaults to true

Using acquisition units (from mod-orders - see https://docs.folio.org/docs/settings/settings_acquisition_units/settings_acquisition_units/) to control access to specific Licenses/Amendments has an impact on performance as it means extra lookups each time a user interacts with the license/amendment to look up their access based on Acquisition Units.

If a tenant does not wish to use Acqusition Units for Licenses, this variable can be set to false

After upgrade

 

@Owen Stephens

https://folio-org.atlassian.net/browse/UXPROD-5605

mod-search

 

Action is not required for all deployments. Apply in case of encountering error like “Cannot get data from search/consortium/batch/holdings“ during Bulk-Edit file upload

Apply at runtime (after upgrade) if issues appear. Set SEARCH_CONSORTIUM_RECORDS_PAGE_SIZE mod-search environment variable to value 3500. In case issue persists - make it lower 2500

For more details on issue which could be fixed by this change see comments in related JIRAs

@Viacheslav Kolesnyk

https://folio-org.atlassian.net/browse/MSEARCH-1194

https://folio-org.atlassian.net/browse/RANCHER-2999