Snapshots
Snapshots is the billing unit of the builds in Widgetbook Cloud. A snapshot is a addon configuration and knob configuration for a use-case inside a build. For example:
- A
Button
use-case can have a "dark" and a "light" configuration when using the Theme addon. - A
Button
use-case can have a "long text" and "short text" configuration when using the string knob.
In short, the snapshots is a matrix between addons configs and knobs configs for each use-case in a build.
![]() | ![]() |
---|---|
![]() | ![]() |
Default Configuration
When you create a build, Widgetbook Cloud will automatically create a default configuration for each use-case. This configuration is the one that is shown when the use-case is first opened in Widgetbook. If you want to add more configurations, you can do so by using the Multi Snapshot feature.
How are snapshots counted?
To estimate your snapshots count per build, you can use the following formula:
Snapshots = Knobs configs * Addons configs
For example, if your build has:
-
3 use-cases:
Button
- 2 knobs configs (short text
andlong text
)Card
- 0 knob config (default configuration is counted as 1)Avatar
- 1 knob config (no image
)
-
2 addons configs:
Dark German
- Dark theme with German LocaleLight English
- Light theme with English Locale
This means that the number of snapshots per build will be as follows:
Knobs configs = 2 (Button) + 1 (Card) + 1 (Avatar) = 4
Addons configs = 2 (Dark German and Light English)
Snapshots = 4 * 2 = 8