<!-- Source: https://docs.squirro.com/en/latest/getting/release/3-15/3.15.2-release-notes.html -->
# 3.15.2 Release Notes

Squirro 3.15.2 was released on March 4, 2026.

Learn more about the [Squirro Release Process](../squirro-release-process.md#getting-squirro-process).

> **Notes for administrators**
>
> This release introduces important changes that may require adjustments to your existing setup. [Learn more](#breaking)

## Improvements

- Extended file upload support for additional Office and text-based document formats.
- Enhanced user permission validation to apply a role-based fallback when project permissions exceed the scope of the user role.
- Added an all-permissions matching method to improve the accuracy of permission validation.
- Added the ability to rename items collections.
- Improved validation for asset and widget endpoints and added boolean type conversion for query parameters.
- Updated the MySQL connection charset from `utf8` to `utf8mb4` to match the table encoding and ensure full Unicode support.

## Bug Fixes

- Single-page PDFs not handled correctly when using the retriever with image reasoning in Squirro Chat.
- `/var/log/squirro/topic/stderr.log` growing continuously due to `DeprecationWarning` messages in wsgiservice-based services.
- Item details loading indefinitely when the chat widget was opened directly from a URL.
- Chat not functioning correctly with RSS data sources.
- Context variable propagation in asynchronous executor calls affecting tracing.
- Semantic search plugin not correctly handling the TERMS array filter syntax.
- Index Manager `/cluster/health` endpoint not responding correctly.
- Double quotes not escaped when applying a facet filter from the Labels widget.
- Incorrect interpolation of encrypted configuration values.
- Collection update operations not returning the correct 409 status code when a collection with the same name already exists.
- World Map widget crashing when the map component was not yet initialized.
- Data loading failures when using the Squirro connector with instances running a version prior to 3.15.1.
- Chat with Document feature missing the item ID when dashboard selections were active.
- Parent item not always cleaned up from the index and neither retried nor moved to a failed batch when sub-items failed to index.

## Known Issues

- In specific scenarios, cross-lingual information retrieval for semantic search may deliver lower-than-expected quality (SQ-28171).
- An error may occur when chatting with an uploaded .pptx file in Squirro Chat (SQ-31480).

## Breaking Changes

- Removed string support for `project_permissions` in [`SquirroClient.new_grant`](../../../api/squirro_client.user.UserApiMixin.md#squirro_client.user.UserApiMixin.new_grant). The method now raises a `ValueError` if a non-list value is provided.

## Installation and Upgrade

For new installations, find step-by-step instructions on the [Install and Manage Squirro with Ansible](../../install/ansible/index.md#ansible) page (recommended) and [Installing Squirro on Linux](../../install/linux.md#install-linux) pages.

To upgrade an existing installation, see the [Upgrading Squirro](../../install/upgrade.md#install-upgrade) page.
