Skip to content

Conversation

@giorgionaps
Copy link
Contributor

@giorgionaps giorgionaps commented Feb 11, 2026

Description

Created a new doc for conditional events with examples

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
  • This is already available but undocumented and should be released within a week. (add available & undocumented label)
  • This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
  • This is part of a scheduled alpha or minor. (add alpha or minor label)
  • There is no urgency with this change (add low prio label)

PR Checklist

  • My changes are for an upcoming minor release and are in the /docs directory (version 8.9).
  • My changes are for an already released minor and are in a /versioned_docs directory.

@giorgionaps giorgionaps requested review from a team February 11, 2026 15:06
@giorgionaps giorgionaps self-assigned this Feb 11, 2026
@giorgionaps giorgionaps requested review from Buckwich and barmac and removed request for a team February 11, 2026 15:06
@giorgionaps giorgionaps added component:modeler Issues related with Modeler project 8.9.0-alpha5 labels Feb 11, 2026
@camunda-docs-pr-automation camunda-docs-pr-automation bot moved this to 👀 In Review in Documentation Team Feb 11, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 11, 2026

👋 🤖 🤔 Hello, @giorgionaps! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.8/.

  • docs/components/concepts/conditions.md
  • docs/components/modeler/bpmn/conditional-events/assets/conditional-events.png
  • docs/components/modeler/bpmn/conditional-events/conditional-events-new.md
  • docs/components/modeler/bpmn/conditional-events/conditional-events.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@christinaausley christinaausley added the deploy Stand up a temporary docs site with this PR label Feb 11, 2026
@github-actions github-actions bot temporarily deployed to camunda-docs February 11, 2026 18:18 Destroyed
Copy link
Contributor

@christinaausley christinaausley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice work! I have given your original doc a technical review, but felt like the lengthier bits of text could be broken into something slightly more readable/consolidated. There are of course many ways to do this, and I wanted to largely leave it up to you, so I created a new file conditional-events-new.md which can be seen in the deploy environment.

In this new file, I've broken up larger chunks of text into a tabbed approach and consolidated things a bit. Feel free to take a look, and you can replace the original conditional-events.md file with this if you want (you'll just need to remove the "new" portion added to the filename, ID, and page title). If you want to go a different direction, you can of course just delete this new file.

@github-actions github-actions bot temporarily deployed to camunda-docs February 11, 2026 18:59 Destroyed
@giorgionaps
Copy link
Contributor Author

Nice work! I have given your original doc a technical review, but felt like the lengthier bits of text could be broken into something slightly more readable/consolidated. There are of course many ways to do this, and I wanted to largely leave it up to you, so I created a new file conditional-events-new.md which can be seen in the deploy environment.

In this new file, I've broken up larger chunks of text into a tabbed approach and consolidated things a bit. Feel free to take a look, and you can replace the original conditional-events.md file with this if you want (you'll just need to remove the "new" portion added to the filename, ID, and page title). If you want to go a different direction, you can of course just delete this new file.

@christinaausley thank you so much for taking the time to reorganize the info, I will take a look at that file & see what's best to use here 🙌

Comment on lines +99 to +106
<bpmn:conditionalEventDefinition id="ConditionalEventDefinition_1">
<bpmn:condition xsi:type="bpmn:tFormalExpression">= x > 1</bpmn:condition>
<bpmn:extensionElements>
<zeebe:conditionalFilter
variableNames="var1, var2"
variableEvents="create, update" />
</bpmn:extensionElements>
</bpmn:conditionalEventDefinition>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🏅 Proper nesting is crucial to make the code readable.


If you omit `zeebe:conditionalFilter`, the engine evaluates the condition on any variable change in the scope. This mirrors the default behavior of Camunda 7 conditional events, using FEEL conditions and Zeebe extensions in Camunda 8.

`variableEvents` is only supported for conditional events within a running scope (for example, intermediate conditional catch events, conditional boundary events, and conditional event subprocess start events). It is not supported for root-level conditional start events, as Camunda Modeler prevents or clears it.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note that we don't support variableEvents for process start event for a reason: There is no process instance in which the events related to the variable could happen yet. Variable events only make sense for an existing process instance.

@barmac
Copy link
Contributor

barmac commented Feb 12, 2026

✅ from my side

@giorgionaps giorgionaps added the hold This issue is parked, do not merge. label Feb 12, 2026
@github-actions github-actions bot temporarily deployed to camunda-docs February 12, 2026 14:34 Destroyed
@github-actions
Copy link
Contributor

🚧 The preview environment for the commit bf380e2 is being built. This usually takes 8-10 minutes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

8.9.0-alpha5 component:modeler Issues related with Modeler project deploy Stand up a temporary docs site with this PR hold This issue is parked, do not merge.

Projects

Status: 👀 In Review

Development

Successfully merging this pull request may close these issues.

3 participants