Forge Object Store is now in Preview, and therefore fully supported. However, it remains under active development and may be subject to shorter deprecation windows. Preview features are suitable for early adopters in production environments.
We release preview features so partners and developers can study, test, and integrate them prior to General Availability (GA). For more details, see Forge EAP, Preview, and GA.
This feature is currently unsupported in Atlassian Government Cloud (AGC) apps. For more information, refer to the AGC feature roadmap.
The Forge Object Store is a hosted storage solution that let you manage large items such as data objects or media files. It provides you with a seamless way to efficiently store, retrieve, and manage objects directly from your Forge apps.
Forge Object Store is not supported on Bitbucket apps.
If the following rate limits are exceeded, Forge will return a TOO_MANY_REQUESTS error.
| Parameter | Limit |
|---|---|
| Object Store requests per minute | 5000 |
| Pre-signed URL requests per second | 1000 |
When building interfaces for object download/uploads, you must use the available frontend components.
| Parameter | Limit |
|---|---|
| Maximum object size | 1 GB |
| Maximum request payload size | 1 kB |
| Pre-signed URL validity | 1 hour |
The maximum object size applies to objects uploaded through any frontend component used in conjunction with the Forge Object Store (for example, the useObjectStore
UI Kit hook).
Meanwhile, the maximum request payload size only applies to the actual Forge Object Store request. This request should only contain the object's name and other relevant metadata (not the object itself).
To use Forge Object Store in an existing app, you must add the objectStore module to your manifest, which triggers a major version upgrade.
Because major versions require admin consent by default, existing installations won't update automatically. You can use Forge's bulk upgrades feature to roll out the latest version and enable Object Store for eligible installations.
The Forge Object Store doesn't limit how long an object can be stored. For what happens to objects when an app is uninstalled or when your app deletes them, see Data lifecycle.
Rate this page: