v1.10.0 - Event-Driven Workflows

[Yeuoly]

Introduce Trigger Functionality

A trigger is a type of Start node that allows your workflow to run automatically—either on a schedule or in response to events from external systems (such as GitHub, Gmail, or your internal services)—without requiring a user action or API call.
Triggers are ideal for automating repetitive processes and integrating workflows with third-party applications to enable seamless data synchronization and processing.

⚡️ Trigger = When something happens → then do something

Triggers form the foundation of event-driven Workflow capabilities and currently support the following types:

• Schedule — time-based triggers
• SaaS Integration Event — events from external SaaS platforms (e.g., Slack, GitHub, Linear) integrated through Plugins
• Webhook — HTTP callbacks from external systems

These trigger features are only available for Workflows. Chatflow, Agent, and BasicChat currently do not support triggers.

🧩 Marketplace

We provide several popular trigger plugins, which you can explore in our Marketplace.

😎 Enjoy the Experience

Sit back, relax, and let your workflows run themselves.

What's Changed

• feat: add flatten_output configuration to iteration node by @Nov1c444 in feat: add flatten_output configuration to iteration node #27502
• feat: implement MCP specification 2025-06-18 by @Nov1c444 in feat: implement MCP specification 2025-06-18 #25766
• feat: introduce RAG tool recommendations and refactor related components for improved plugin management by @WTW0313 in feat: Introduce RAG tool recommendations and refactor related components for improved plugin management #27259
• feat: enhance tencent trace integration with LLM core metrics by @minimAluminiumalism in feat: enhance tencent trace integration with LLM core metrics #27126
• feat: use id for webapp by @GareArc in feat: use id for webapp #27576
• feat: enhance pipeline template list with marketplace feature toggle by @WTW0313 in feat: enhance pipeline template list with marketplace feature toggle #27604
• feat(api): Introduce workflow pause state management by @QuantumGhost in feat(api): Introduce workflow pause state management #27298
• feat: localization for hi-IN by @SmartDever02 in feat: localization for hi-IN #27783
• feat: Add Audio Content Support for MCP Tools by @IthacaDream in feat: Add Audio Content Support for MCP Tools #27979
• feat(api): Introduce Broadcast Channel by @QuantumGhost in feat(api): Introduce Broadcast Channel #27835
• feat(api): Introduce WorkflowResumptionContext for pause state management by @QuantumGhost in feat(api): Introduce WorkflowResumptionContext for pause state management #28122
• feat: introduce trigger functionality by @Yeuoly in feat: introduce trigger functionality #27644
• feat: add segments max number limit for SegmentApi.post by @ruanimal in feat: add segments max number limit for SegmentApi.post #27745
• feat: enhance annotation API to support optional message_id and content fields by @liugddx in feat: enhance annotation API to support optional message_id and content fields #27460
• feat: add validation to prevent saving empty opening statement in conversation opener modal by @Nov1c444 in feat: add validation to prevent saving empty opening statement in conversation opener modal #27843
• feat: change feedback to forum by @crazywoola in feat: change feedback to forum #27862
• feat: add draft trigger detection to app model and UI by @zhsama in feat: add draft trigger detection to app model and UI #28163
• feat: enhance start node metadata to be undeletable in chat mode by @zhsama in feat: enhance start node metadata to be undeletable in chat mode #28173
• fix issues 27388, add missing env variable: ENFORCE_LANGGENIUS_PLUGIN… by @MaoJianwei in fix issues 27388, add missing env variable: ENFORCE_LANGGENIUS_PLUGIN… #27545
• fix: resolve 500 error when updating document chunk settings (Update chunk setting failed #27551) by @quicksandznzn in fix: resolve 500 error when updating document chunk settings (#27551) #27574
• fix: iteration node cannot be viewed(After upgrading to Dify 1.9.2, if an iteration node in the workflow fails to execute, the internal information of the iteration node cannot be viewed. #27759) by @redSun64 in fix: iteration node cannot be viewed(#27759) #27786
• fix agent putout the output of workflow-tool twice (Agent putout the output of workflow-tool twice #26835) by @Cursx in fix agent putout the output of workflow-tool twice (#26835)  #27706
• fix:knowledge base reference information is overwritten when using mu… by @zhengchangchun in fix:knowledge base reference information is overwritten when using mu… #27799
• fix: installation_id is missing when in tools page by @crazywoola in fix: installation_id is missing when in tools page #27849
• fix: avoid passing empty uniqueIdentifier to InstallFromMarketplace by @johnny0120 in fix: avoid passing empty uniqueIdentifier to InstallFromMarketplace #27802
• fix: python package vulnerability by @kenwoodjw in fix: python package vulnerability #27645
• fix(api): return timestamp as integer in document api by @invzhi in fix(api): return timestamp as integer in document api #27761
• fix: File model add known extra fields, fix issue about the tool of… by @CrabSAMA in fix: File model add known extra fields, fix issue about the tool of… #27607
• FIX Issue Frontend cannot to Render Inline Formulas When Using Docker Self-Host #27697: Add env variable in docker-compose(template) and make it take effect. by @Dave0126 in FIX Issue #27697: Add env variable in docker-compose(template) and make it take effect. #27704
• fix: datasets weight settings embedding model does not change by @lcedaw in fix: datasets weight settings embedding model does not change #27694
• fix: bump pyobvector to 0.2.17 by @kenwoodjw in fix: bump pyobvector to 0.2.17 #27791
• fix: elasticsearch_vector version by @huangzhuo1949 in fix: elasticsearch_vector version #28028
• fix workflow default updated_at by @IthacaDream in fix workflow default updated_at #28047
• fix(api): Trace Hierarchy, Span Status, and Broken Workflow for Arize & Phoenix Integration by @ialisaleh in fix(api): Trace Hierarchy, Span Status, and Broken Workflow for Arize & Phoenix Integration #27937
• fix Version 2.0.0-beta.2: Chat annotations Api Error Version 2.0.0-beta.2: Chat annotations Api Error #25506 by @Cursx in fix Version 2.0.0-beta.2: Chat annotations Api Error #25506  #27206
• fix: prevent fetch version info in enterprise edition by @douxc in fix: prevent fetch version info in enterprise edition #27923
• fix(api): fix VariablePool.get adding unexpected keys to variable_dictionary by @QuantumGhost in fix(api): fix VariablePool.get adding unexpected keys to variable_dictionary #26767
• fix: bump brotli to 1.2.0 resloved CVE-2025-6176 by @kenwoodjw in fix: bump brotli to 1.2.0 resloved CVE-2025-6176 #27950
• refactor: update installed app component to handle missing params and improve type safety by @ZeroZ-lab in refactor: update installed app component to handle missing params and improve type safety #27331
• refactor:Decouple Domain Models from Direct Database Access by @hieheihei in refactor:Decouple Domain Models from Direct Database Access #27316
• refactor: update install status handling in plugin installation process by @WTW0313 in refactor: update install status handling in plugin installation process #27594
• refactor(api): add SQLAlchemy 2.x Mapped type hints to Message model by @laipz8200 in refactor(api): add SQLAlchemy 2.x Mapped type hints to Message model #27709
• refactor: replace hardcoded user plan strings with CloudPlan enum by @laipz8200 in refactor: replace hardcoded user plan strings with CloudPlan enum #27675
• refactor: Use Repository Pattern for Model Layer by @hieheihei in refactor: Use Repository Pattern for Model Layer #27663
• refactor(api): set default value for EasyUIBasedAppGenerateEntity.query by @laipz8200 in refactor(api): set default value for EasyUIBasedAppGenerateEntity.query #27712
• refactor(web): reuse the same edit-custom-collection-modal component, and fix the pop up error by @yangzheli in refactor(web): reuse the same edit-custom-collection-modal component, and fix the pop up error #28003
• refactor(web): remove redundant add-tool-modal components and related code by @yangzheli in refactor(web): remove redundant add-tool-modal components and related code #27996
• chore: translate i18n files and update type definitions by @github-actions[bot] in chore: translate i18n files and update type definitions #27423
• chore(deps): bump testcontainers from 4.10.0 to 4.13.2 in /api by @dependabot[bot] in chore(deps): bump testcontainers from 4.10.0 to 4.13.2 in /api #27469
• chore(deps-dev): bump @happy-dom/jest-environment from 20.0.7 to 20.0.8 in /web by @dependabot[bot] in chore(deps-dev): bump @happy-dom/jest-environment from 20.0.7 to 20.0.8 in /web #27465
• chore: add more stories by @hjlarry in chore: add more stories #27403
• chore: improve mcp server url validation by @Nov1c444 in chore: improve mcp server url validation #27558
• Sync celery queue name list by @Eric-Guo in Sync celery queue name list #27554
• chore: add web type check step to GitHub Actions workflow by @ZeroZ-lab in chore: add web type check step to GitHub Actions workflow #27498
• chore: warning messages too long in model config caused ui issue by @iamjoel in chore: warning messages too long in model config caused ui issue #27542
• chore: add type-check to pre-commit by @lyzno1 in chore: add type-check to pre-commit #28005
• chore(deps): bump tablestore from 6.2.0 to 6.3.7 in /api by @dependabot[bot] in chore(deps): bump tablestore from 6.2.0 to 6.3.7 in /api #27736
• chore(deps): bump dayjs from 1.11.18 to 1.11.19 in /web by @dependabot[bot] in chore(deps): bump dayjs from 1.11.18 to 1.11.19 in /web #27735
• chore(deps): bump scipy-stubs from 1.16.2.3 to 1.16.3.0 in /api by @dependabot[bot] in chore(deps): bump scipy-stubs from 1.16.2.3 to 1.16.3.0 in /api #28025
• chore: disable workflow logs auto-cleanup by default by @laipz8200 in chore: disable workflow logs auto-cleanup by default #28136
• chore: not SaaS version can query long log time range by @iamjoel in chore: not SaaS version can query long log time range #28109
• chore: improve the user experience of not login into apps by @iamjoel in chore: improve the user experience of not login into apps #28120
• chore: Remove trailing space from migration filename by @IthacaDream in chore: Remove trailing space from migration filename #28040
• chore: translate i18n files and update type definitions by @github-actions[bot] in chore: translate i18n files and update type definitions #28054
• chore: remove unused enterprise bot from the readme by @crazywoola in chore: remove unused enterprise bot from the readme #28073

New Contributors

• @gin-melodic made their first contribution in Bugfix: Windows compatibility issue with 'cp' command not found when running pnpm start. (#25670) #25672
• @acro-k-tanaka made their first contribution in improve opensearch index deletion　#27231  #27336
• @MaoJianwei made their first contribution in fix issues 27388, add missing env variable: ENFORCE_LANGGENIUS_PLUGIN… #27545
• @Vivecccccc made their first contribution in set conditional capabilities upon MCP client session initialization #26234
• @katakyo made their first contribution in i18n(ja-JP): Use 「公開」 for App Overview “Launch” action label #27680
• @SmartDever02 made their first contribution in Added it-IT for italian #27665
• @tonghuaroot made their first contribution in fix: Clarify security terminology in contribution guidelines #27731
• @SherlockShemol made their first contribution in web(markdown): support <think> without trailing newline in preprocessThinkTag #27776
• @dingweichen made their first contribution in fix: two web bugs for json-schema-config-modal #27718
• @invzhi made their first contribution in fix(api): return timestamp as integer in document api #27761
• @Dave0126 made their first contribution in FIX Issue #27697: Add env variable in docker-compose(template) and make it take effect. #27704
• @y49 made their first contribution in fix: improve infinite scroll observer responsiveness #27546
• @redSun64 made their first contribution in fix: iteration node cannot be viewed(#27759) #27786
• @Cursx made their first contribution in fix agent putout the output of workflow-tool twice (#26835)  #27706
• @zhengchangchun made their first contribution in fix:knowledge base reference information is overwritten when using mu… #27799
• @Elliott-byte made their first contribution in fix(web): increase z-index of PortalToFollowElemContent #27823
• @codomposer made their first contribution in test: create new test scripts and update some existing test scripts o… #27850
• @kk-wangjifeng made their first contribution in Fix/template transformer line number #27867
• @OneZero-Y made their first contribution in docs: clarify how to obtain workflow_id for version execution #28007
• @mnasrautinno made their first contribution in fix: app's ai site text to speech api #28091
• @ye4241 made their first contribution in fix: correct spelling of "模板" in translation files #28151
• @Cerlancism made their first contribution in fix(moderation): change OpenAI moderation model to omni-moderation-la… #28119
• @breath57 made their first contribution in fix(knowledge-base): regenerate child chunks not working completely #27934
• @zhsama made their first contribution in feat: add draft trigger detection to app model and UI #28163
• @lilongfei2000 made their first contribution in Fix: Correctly handle merged cells in DOCX tables to prevent content duplication and loss #27871
• @hoffermei made their first contribution in fix: StreamableHTTPTransport got invalid json exception when receive a ping event from mcp server #28111 #28116

Full Changelog: 1.9.2...1.10.0

---

This discussion was created from the release v1.10.0 - Event-Driven Workflows.