Last updated Sep 18, 2025

Ending Connect support

You can no longer publish Connect apps on the Atlassian Marketplace. All new extensibility features will be delivered only on Forge.

Refer to this blog post for our timeline to end Connect support.

Have an existing Connect app? You can incrementally migrate it to Forge.

Flag

Flags are the primary method for providing system feedback in the product user interface. Messages include notifications of various kinds: alerts, confirmations, notices, warnings, info and errors.

Methods

create (options)

Creates a new flag.

Parameters

Name

Type

Description

options

Object

Options of the flag.

Properties

Name	Type	Default	Description
title	String		The title text of the flag.
body	String		The body text of the flag.
type	String	info	Sets the type of the message. Valid options are "info", "success", "warning" and "error".
close	String		The closing behaviour that this flag has. Valid options are "manual", and "auto".
actions	Object		Map of {actionIdentifier: 'Action link text'} to add to the flag. The actionIdentifier will be passed to a 'flag.action' event if the link is clicked.

Returns

Flag~Flag

Example

1
2
// Display a nice green flag using the Flags JavaScript API.
var flag = AP.flag.create({
  title: 'Successfully created a flag.',
  body: 'This is a flag.',
  type: 'success',
  actions: {
    'actionkey': 'Click me'
  }
});