Userscripts for Confluence defines a userscript in form of a descriptor with a reference to the actual script code.

The userscript is configured for users by the administration team. Hence users can benefit from additional functions without bothering to validate the fitness of a script for their task by themselves. This makes extending Confluence easier, especially for team members without programming skills. While these additional features can be implemented in form of Confluence apps, many utilities simply rely on a short amount of JavaScript code. These few lines of code are easily shared and boost the productivity of teams.

The userscript consists of

1. an 

   Static Document Link
   document Userscript Identifier label identifier

   consisting of

   Static Document Link
   document Userscript Namespace label ${Short Name} to-lower-case true

   , 

   Static Document Link
   document Userscript Name label ${Short Name} to-lower-case true

   , and 

   Static Document Link
   document Userscript Version label ${Short Name} to-lower-case true

2. a reference to the userscript code (scriptthe 

   Static Document Link
   document Userscript Code to-lower-case true

   (

   Static Document Link
   document Userscript Code URL label script

   )
3. metadata, like a a description, a reference to further information (documentation), and an author
4. an activation record (activation) that defines when the userscript is actually executed

The following fragment shows the basic structure of a

{
  "namespace": "...",
  "name": "...",
  "version": "...",

  "script": "...",

  "description": "...",
  "documentation": "...",
  "author": "...",

  "activation": {
     ...
  }
}