Last date modified: 2025-Aug-25

Advanced Formatting for Branding

Advanced Formatting is a type of branding available on the Production Set form. See Branding.

With Advanced Formatting, you can brand headers and footers with a combination of fields from the Advanced Formatting drop-down list, free-form text, and carriage returns. The Advanced Formatting option also supports a scripting language that you can use to create conditional branding based on production, document, and page fields.

Advanced Formmatting

For conditional statements, the root context objects are

Production object
Document object
Page object

If you add a field to a conditional statement incorrectly, you can still save and run the production set, but the branding will not generate an error and will produce incorrect results.

Production object

The production object stores information about the production. It is the same for every item branded in the production.

Name	Data type	Description	Name in Advanced Formatting drop-down list
Document	DocumentDrop	The current document being branded.	N/A
ProductionId	int	The ID of the workspace.	Production Id
ProductionName	string	The name of the production.	Production Name
TotalDocuments	int	The total number of documents in the production.	Total Documents
TotalImages	int	The total number of images in the production.	Total Images
WorkspaceId	int	The ID of the production.	Workspace Id

Example of Advanced Formatting with the production object

The example in this section does not demonstrate everything that you can do with the production object.

As shown in the screen shot below, you can combine free-form text with productions objects.

Advanced formatting with the production object

Copy

1
Number of documents in {{context.ProductionName}}: {{context.TotalDocuments}}

The screen shot below shows a document that was branded per the command in the screen shot above. In this example, the ProductionName is Production object conditional statement, and the TotalDocuments is 15.

Advanced formatting on the production object branded

Document object

This object stores information about the document and will change for each document.

Name	Data type	Description	Name in Advanced Formatting drop-down list
ArtifactId	int	The ArtifactId of the document in the production.	Artifact Id
HasRedactions	bool	If set, the current document contains redactions on at least one page.	Document Has Redactions
HasPlaceholder	bool	If set, the current document is a placeholder.	Has Placeholder
BeginBates	string	The first bates number in this document.	Begin Bates
EndBates	string	The last bates number in this document.	End Bates
BeginBatesAttachment	string	The first attachment bates number in this document.	Begin Bates Attachment
EndBatesAttachment	string	The last attachment bates number in this document.	End Bates Attachment
Page	PageDrop	The current page being branded.	N/A
["Field Name"]	FieldDrop	Returns the field value of the specified document field. This will return null if the field does not exist or is not supported. e.g. context.Document["Control Number"].Value Only the following field types are supported: These values are in string format as done in object manager. Custom Placeholders also supports these field types. Reflected fields are not supported. case FieldType.Date case FieldType.Decimal case FieldType.FixedLengthText case FieldType.WholeNumber case FieldType.YesNo case FieldType.SingleChoice case FieldType.MultipleChoice	N/A

Example of Advanced Formatting with the document object

The example in this section does not demonstrate everything that you can do with the document object.

As shown in the screen shot below, you can create conditional statements with the document object.

Conditional statement

Copy

1
2
3
{% if context.Document.HasRedactions %}
THIS DOCUMENT HAS REDACTIONS
{% endif %}

The document in the screen shot below is branded per the command in the screen shot above. Since the document has a redaction, it meets the requirements of the conditional statement, so the free-form text is branded on this document.

Document object conditional statement branded

Page object

The page object stores information about the page and will change for each page.

Name	Data type	Description	Name in Advanced Formatting drop-down list
BatesNumber	string	The bates number of the current page.	Bates Number
FileName	string	The name of the file.	File Name
HasRedactions	bool	If set, this page has redactions.	Page Has Redactions
IsPlaceholder	bool	If true, this page is a placeholder page.	Is Placeholder
PageNumber	int	The current page.	Page Number

Example of Advanced Formatting with the page object

The example in this section does not demonstrate everything that you can do with the page object.

As shown in the screen shot below, you can use page objects in conditional statements.

Page level conditional statement

Copy

1
2
3
4
5
6
7
8
{% if context.Document.Page.PageNumber == 1 %}
Only brand this text on page 1.
{% endif %}

{% if context.Document.Page.PageNumber > 1 %}
Brand Bates number on every page after page 1:
{{context.Document.Page.BatesNumber}}
{% endif %}

The document in the screen shot below is branded per the commands in the screen shot above. The free-form text from the first conditional statement is only printed on the first page. The free-form text from the second conditional statement is only printed on the second page.

A document branded per the commands in the screen shot above

Script examples

Below are Advanced Formatting script examples:

Brand the free-text, Production Name, and Page Number on every page.

Copy

1
2
Production Name: {{context.ProductionName}}
Page # {{context.Document.Page.PageNumber}}

Brand the free-text on pages that have redactions.

Copy

1
2
3
{% if context.Document.Page.HasRedactions%}
THIS PAGE CONTAINS REDACTIONS
{% endif %}

Brand the free-text on pages that have a specific page number.

Copy

1
2
3
{% if context.Document.Page.PageNumber == 1 %}
This text will be branded only on page 1
{% endif %}

Brand the Bates Number on every page after page number 1.

Copy

1
2
3
{% if context.Document.Page.PageNumber > 1 %}
{{context.Document.Page.BatesNumber}}
{% endif %}

Brand the free-text on the pages that fall between a page range.

Copy

1
2
3
{% if context.Document.Page.PageNumber  > 1 and context.Document.Page.PageNumber  < 11%}
Confidential 
{% endif %}

Copy

1
2
3
{% if context.Document.Page.PageNumber  > 11 and context.Document.Page.PageNumber  < 21%}
Attorneys’ Eyes Only
{% endif %}

Brand the document that has a document field with specific value.

Copy

1
{% if context.Document["Confidentiality"].Value == "Attorneys’ Eyes Only" %}

Copy

1
Confidential - Attorneys’ Eyes Only

Copy

1
{% endif %}