Bixby Developer Center

Build Conversational Experiences
References

aspect-ratio

optionalvalue optional

Determines image card's aspect ratio.

You can specify the following aspect ratios, which you can see in the image-card interactive demo:

  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • 9:21
Note

If you use an aspect ratio that is taller than wider, the cards will group together to fit the width of the screen, in column mode.

For example, here are some image cards from the Bixby Views sample capsule with a 9:16 aspect ratio on mobile:

Cards grouped

The 3:4 cards display in two columns, while 9:16 and 9:21 display in three columns.

If you want to change the number of columns displayed when your image cards are in a list, use the column-size key.

Examples

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

Child Keys

value
optional
A value that matches one of the valid enumerated options of its parent key

Copyright 2025 Samsung All rights reserved