Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

About the static JavaServer Page tag

Updated on August 10, 2022

Use the static JSP tag to cause one or more static file bundles, individual text files, or individual binary files to be included in the current stream. A static file bundle rule identifies a list of JavaScript, image, and Cascading Style Sheet files to be sent to a browser session together in one HTTP response, to reduce HTTP traffic and improve response time to the browser user.

For example:

<pega:static type="script" app="webwb" >
	<pega:bundle name="pega_tools" />
	<pega:bundle name="acmestyles" />
	<pega:file name="markov.js" />
	<pega:binaryfile name="johnson.gif" app="webwb" />

This tag references two static bundle rules pega_tools.script and Acmestyles.script, which in turn may identify multiple text file rules ( Rule-File-Text rule type) containing JavaScript scripts.

The <pega:file > tag identifies a single text file rule (a JavaScript file, webwb.markov.js) to be included in the stream. Similarly, the <pega:binary tag> identifies a single binary file rule (an image) to be included in the stream.

When to use

For example, when entering HTML source code directly into the HTML tab of a control rule (or similar form), you can minimize the size of the resulting HTML document with the <pega:onlyonce >, <pega:bundle> and <pega:static > tags.

Complete syntax

In the syntax presentation below:

  • JSP delimiters <pega:...> and </pega:...> mark the start and end of the tag.
  • Replace any text in italics with your choice of value of that type.
<pega:static app="applicationname" type="type">
<!-- one or more pega:bundle JSP tags -->
<!-- one or more pega:file JSP tags -->

The type attribute is required.

You can include a pega:when tag within the static tag scope, to conditionalize which bundles or files are included.

References to CSS files (in the form of the <link rel="stylesheet" ...> tag) must appear within the <head> element of an HTML document. In contrast, a <script ..> tag can appear anywhere in the document.

app The first key part ( Application Name Directory ) of the text file rule included in the <pega:static..> tag. All files included within one <pega:static ..> tag must have a common Application Name
type One of two values to identify the type of content in the bundle rules:
  • script — all listed bundle rules have script as the second key part
  • style — all listed bundle rules have style as the second key part
prefixURLReserved. Do not use.


If your application includes JavaScript files, CSS files, or other static content saved in multiple text file rules that are needed together at runtime on the user workstation, group them into a bundle.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us