Bixby Developer Center


20A Capsule SDK Release Notes


Internal platform changes that are not visible to capsule developers will be communicated via internal status updates.

Updated: March 18, 2020

New Thumbnail Area Component in Bixby Views

The size key in cards and images is now deprecated. Use the new aspect-ratio key to specify how an image or a card fits in a Bixby View.


image-card {
size (L)


image-card {
aspect-ratio (4:3)

Deprecation Stages (learn more)

  • Stage 1: R19O
  • Stage 2: R19O
  • End of Life: R19U

New Runtime Version 3

We've added a new runtime version that covers a number of runtime flags:

  • concepts-inherit-super-type-features
  • no-filtering-with-validation
  • modern-default-view-behavior
  • modern-prompt-rejection
  • support-halt-effect-in-computed-inputs
  • use-authorization-header-for-remote-endpoint-oauth
  • use-input-views-for-selection-list-detail

For more information, read about runtime version 3.

Batch 7 Categories Released

The following NL categories were added this release:

  • AudioBook
  • MovieTickets
  • Lottery
  • Trivia
  • JobSearch
  • SportsScore

'$user.nickName' Deprecated

We've deprecated the $user.nickName EL function because it never returned a value.

Deprecation Stages (learn more)

  • Stage 1: R20A
  • Stage 2: R20D
  • End of Life: R20O

Enum Subtypes Can No Longer Be Extended

You can no longer add symbols to an extended enum. This is because if an enum is subtyped and the subtype attempts to add additional symbols that aren't legal values enumerated in the supertype, that "is-a" relationship no longer holds.

Deprecation Stages (learn more)

  • Stage 1: R19X
  • Stage 2: R20A
  • End of Life: None

Updates to User Location Capsule Permission

If you previously used the user-profile-access permission for accessing the user's location, you now should now use the device-location-access permission. The user-profile-access permission will soon be deprecated.

Required Justification for Capsule Permissions

If you are requesting permissions in your capsule-info.bxb, you must now provide a localized justification using the requested-permissions key, which is then presented to the user:

capsule-info {
requested-permissions {
permission (user-profile-access) {
justification (Your location will be used to find restaurants nearby)

Deprecation Stages (learn more)

  • Stage 1: R20A
  • Stage 2: R20G
  • End of Life: R20O