Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
UI Kit components
Jira UI Kit components
UI Kit hooks
Forge bridge APIs
Jira bridge APIs
Confluence bridge APIs
Dashboard bridge APIs (EAP)
Upgrade UI Kit versions
Last updated Aug 26, 2025

widget (EAP)

Forge's EAP offers experimental features to selected users for testing and feedback purposes. These features are unsupported and not recommended for use in production environments. They are also subject to change without notice. For more details, see Forge EAP, Preview, and GA.

To participate, you can sign up for the EAP here.

Note: You must also opt-in to the open beta of Dashboards in Atlassian Home. See the guide on how to opt-in.

Use the widget APIs for dashboard widget view operations.

For module configuration and setup instructions, see Dashboard widget.

Setting preview configuration

widget.setPreviewConfig

Sets the preview configuration for the widget that appears when selected in the widget list. The configuration object replaces config in useWidgetConfig when the widget is rendered as a preview.

Usage

1
2
import { widget } from "@forge/dashboards-bridge";

widget.setPreviewConfig({
  title: "Preview Title",
  description: "This is a preview configuration",
});

Parameters:

  • previewConfig (WidgetConfig): The preview configuration object

Method signature

1
2
function setPreviewConfig(previewConfig: WidgetConfig): void;

type WidgetConfig = Record<string, unknown>;

Rate this page: