Bixby Developer Center

Build Conversational Experiences
References

runtime-version

optionalvalue required

Changes specific runtime behavior during the execution of the capsule depending on the version. Each runtime version has an explicit set of runtime flags set, which you can change with the overrides key.

Examples

capsule {
  ...
  runtime-version (2) {  // required
    overrides {  // optional
      no-fallback-to-result-collections (true)  // explicitly turns this behavior on
      concepts-inherit-super-type-features (false)  // explicitly turns this behavior off
      ...
    }
  }
}
  runtime-version (7) {
    overrides {
      allow-dialogs-on-detail-pages (true)
      no-fallback-to-result-collections (true)
      no-fallback-dialog-in-views (false)
    }

View 0690617 on GitHub

Versions

This section lists the versions the runtime flags are on by default, changes between runtime versions, and a list of which flags are enabled or disabled for all versions. You can click on each runtime flag to read more about how that flag effects runtime execution. Each flag's reference page also lists for which versions they are turned on by default.

Caution

Updating the runtime version can have unintended side effects and might break your capsule. Ensure you test your capsule thoroughly when updating the runtime version to ensure it has no undesired results.

Default Versions

The table below lists the flag with a link to its reference page, as well as a short description of the flag and which versions the flag is set to true as a default.

| Flag | Description | Default In Versions | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---- | | allow-dialogs-on-detail-pages | Allows capsules to show dialog when they progress from a summary view to a detail view. | None | | allow-empty-fragments-in-dialog-templates | Allows capsules to use dialog fragments/macros that evaluate to empty strings in dialog templates. | Version 8 or later | | allow-wildcard-matches-on-imported-resources | Controls the scope of wildcard matches defined in an imported library capsule. | None | | auto-insert-navigation-conversation-drivers | Automatically adds "Previous" and "Next" conversation drivers to lists in Bixby Views. | Version 5 or later | | auto-on-click-for-list-of | Enables auto-selection behavior for list-of. | Version 1-6 | | avoid-page-selection-command-due-to-ambiguity | Prefer next page navigation command to page selection command in case of ambiguity in a user utterance. | None | | concepts-inherit-super-type-features | Enables concepts to inherit features (such as transient or preferable) when extending or being a role-of their parent type (also known as super-type). | Version 2 or later | | disable-voice-content-selection | Enables or disables voice content selection in views. | None | | enhanced-list-navigation | Change default list navigation behavior. | None | None | | modern-default-view-behavior | Changes behavior when a result view or input view is not defined. | Version 1 or later | | modern-prompt-rejection | Changes the behavior of how input prompt responses are handled. | Version 2 or later | | no-auto-property-value-merging | Ensures that equivalent values of a property within a node will not be merged. | Version 4 or later | | no-default-init-when-input-already-instantiated | Changes the behavior of default-init. | Version 9 or later | | no-fallback-dialog-in-views | Prevent falling back to a default dialog if no message is defined in a view. | Version 6 or later | | no-fallback-to-result-collections | Renders nothing if no result view is specified. | None | | no-filtering-with-validation | Changes how Bixby applies validation conditions to reduce the number of ambiguous values. | Version 1 or later | | relax-inputs-on-confirmation-denial | Change how to handle cases when the user denies a confirmation prompt. | None | | result-view-capsule-lock | Enables automatic opt-in for capsule lock within result views with conversation drivers | Version 1 or later | | short-timeout-on-halt-dialog | Changes the conversation timeout length after a halt effect. | Version 1 or later | | show-ordinals-on-list | Controls whether to display item numbers in lists in result and input views. | None | None | | support-halt-effect-in-computed-inputs | Enables halting execution while doing a computed-input. | Version 2 or later | | use-authorization-header-for-remote-endpoint-oauth | Uses an Authorization header when an HTTP request to a remote-endpoint requires OAuth. | Version 3 or later | | use-input-views-for-selection-list-detail | Changes how a single result is rendered within an input-view. | Version 2 or later | | use-most-specific-instantiation-strategy | Uses the MostSpecific match mode for an instantiation strategy in the default-init of an action. | Version 4 or later |

Runtime Version 1

capsule {
  ...
  runtime-version (1)
}

These flags were added to runtime-version (1):

Runtime Version 2

capsule {
  ...
  runtime-version (2)
}

These flags were added to runtime-version (2):

Runtime Version 3

capsule {
  ...
  runtime-version (3)
}

This flag was added to runtime-version (3):

Runtime Version 4

capsule {
  ...
  runtime-version (4)
}

These flags were added to runtime-version (4):

Runtime Version 5

capsule {
  ...
  runtime-version (5)
}

This flag was added to runtime-version (5):

Runtime Version 6

capsule {
  ...
  runtime-version (6)
}

This flag was added to runtime-version (6):

Runtime Version 7

capsule {
  ...
  runtime-version (7)
}

This flag was removed from runtime-version (7):

Runtime Version 8

capsule {
  ...
  runtime-version (8)
}

This flag was added to runtime-version (8):

Runtime Version 9

capsule {
  ...
  runtime-version (9)
}

These flags were added to runtime-version (9):

Defaults in All Versions

Flags enabled by default in all runtime versions:

Flags disabled by default in all runtime versions:

Child Keys

js-runtime-version
optional
Sets the JavaScript Runtime version
overrides
optional
Explicitly enables (true) or disables (false) a runtime flag within a runtime version

Copyright 2025 Samsung All rights reserved