⚠️ Breaking Change
Impact Score: 7/10
Dify: Version 0.3.21
Source available — automated, not human-reviewed
Component: dify · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
Breaking-change evidence from the source
⚠️ [BREAKING CHANGE] ⚠️ - The fixed parameters of the `Query content` in the text generation application have been removed. Users can freely add any variables in the prompt, instead of appending the content of the query content at the end.
⚡ Executive Summary (TL;DR)
Dify 0.3.21. Source highlight: ⚠️ [BREAKING CHANGE] ⚠️
Who Does This Impact? (Role-Based Analysis)
💻 Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
📊 Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
⚙️ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
⚠️ Breaking Changes & Deprecations (1)
- ⚠️ [BREAKING CHANGE] ⚠️ - The fixed parameters of the `Query content` in the text generation application have been removed. Users can freely add any variables in the prompt, instead of appending the content of the query content at the end.
✨ New Features & Capabilities (4)
- feat: support optional query content
- feat: cache huggingface gpt2 tokenizer files
- feat: set transformers offline default true
- feat: bump version to 0.3.21
🔧 Bug Fixes & Patches (5)
- The fixed parameters of the `Query content` in the text generation application have been removed. Users can freely add any variables in the prompt, instead of appending the content of the query content at the end.
- fix: in log page not show user query
- fix: log page compatible old query
- fix: remove the deprecated depends_on.condition format
- fix: TRANSFORMERS_OFFLINE orders in Dockerfile
📄 View Raw Release Notes (Original Developer Log)
## ⚠️ [BREAKING CHANGE] ⚠️
- The fixed parameters of the `Query content` in the text generation application have been removed. Users can freely add any variables in the prompt, instead of appending the content of the query content at the end.
- The `query` parameter in the `POST /v1/completion-messages` endpoint of the App OpenAPI is expected to be completely removed in 3 months. Currently, it's optional and the parameter in API documentation has already been removed.
To ensure that the previous applications can still function properly after removing the fixed parameters in the query content of the text generation application, we need to execute a command to fix the data:
### Migration Guide
1. **Enter the Docker Container**: Before running the migration script, you need to enter the Docker container where your application is running. Use the following command:
```shell
docker exec -it docker-api-1 bash
```
2. **Run the Migration Script**: Once inside the container, execute the following migration command. The migration script can be executed multiple times without side effects:
```shell
# --batch-size: Specifies the number of records migrated per batch, default is 500
flask update_app_model_configs --batch-size=500
```
## What's Changed
* feat: support optional query content by @iamjoel in https://github.com/langgenius/dify/pull/1097
* fix: in log page not show user query by @iamjoel in https://github.com/langgenius/dify/pull/1140
* fix: log page compatible old query by @iamjoel in https://github.com/langgenius/dify/pull/1141
* fix: remove the deprecated depends_on.condition format by @takatost in https://github.com/langgenius/dify/pull/1142
* feat: cache huggingface gpt2 tokenizer files by @takatost in https://github.com/langgenius/dify/pull/1138
* feat: set transformers offline default true by @takatost in https://github.com/langgenius/dify/pull/1143
* fix: TRANSFORMERS_OFFLINE orders in Dockerfile by @takatost in https://github.com/langgenius/dify/pull/1144
* feat: bump version to 0.3.21 by @takatost in https://github.com/langgenius/dify/pull/1145
**Full Changelog**: https://github.com/langgenius/dify/compare/0.3.20...0.3.21