Skip to main content

Template Management

Overview

The Template Manager in OmegaAI allows medical professionals to create, manage, and publish structured report templates. Templates define the layout, sections, and placeholder fields that auto-fill when a report is generated — streamlining documentation and ensuring consistency across reports.

Accessing the Template Manager

To open the Template Manager in OmegaAI:

  • Open a study in the Document Viewer.

  • Click the three-dot menu located above the document viewport.

  • Select Template Manager from the dropdown list.

Accessing the Template Manager

The Template Manager panel opens on the left, displaying all available templates.

Template Manager

Template Explorer

The count badge next to "Template Manager" shows the total number of templates available. Each item in the list shows the template name, modality (e.g. ALL, CR, MR, CT), body part, and the owner's name below. The currently selected template is highlighted with a blue left border and opens in the editor on the right. Hovering over a template card displays a live preview of the template.Template Explorer
Searching Templates — Click the search icon at the top of the sidebar to search for a template by name. Results update as you type.Searching Templates
Renaming a Template — Hover over a template card to reveal the action icons, then click Edit. The template name becomes an inline editable field — type the new name, then click the checkmark to confirm or to cancel.Renaming a Template
Deleting a Template — There are two ways to delete a template: Single delete — hover over a template card to reveal the trash icon, then hold it to delete. Bulk delete — select multiple templates using the checkboxes, then click the trash icon in the bottom action bar. The bar shows the count of selected items (e.g. 2 Items) and a button to clear the selection. Deleting a template is permanent. It does not affect reports already generated from that template.Deleting a Template

Creating a Template

There are two ways to create a template in OmegaAI:

Method 1: Upload a Template

Upload an existing template file in .pdf or .docx format. This is useful when you already have a structured report layout ready to import.

There are two ways to upload:

Option A: Click the Upload button — Click the Upload Template icon at the top of the Template Manager sidebar, then select your .pdf or .docx file from your computer.Upload Template Button

Option B: Drag and drop**.** Drag your .pdf or .docx file from your computer and drop it onto the "Drop file to upload" area at the bottom of the sidebar.

Drag and Drop Upload

In both cases, an upload progress notification appears at the bottom of the screen. Once complete, a confirmation toast displays "Uploaded," and the template automatically opens in the editor, ready for editing.

Tip: Not sure where to start? Use an existing Word or PDF report as your upload — it gives you a ready-made structure to build on rather than starting from scratch.

Method 2: Start with a Blank Template

Select Blank from the template list as a starting point. The blank template opens with three distinct areas:

  • Header — hover over the top area to reveal and edit the header. Use this for facility name, logo, report title, or other information that should appear on every page.

  • Body — the main content area. The hint "Type # to insert bookmark" is shown here as a guide. Add your report sections, text, and bookmarks in this area.

  • Footer — hover over the bottom area to reveal and edit the footer. Use this for page numbers, disclaimers, or contact details.

Blank Template

Click directly on the Header or Footer area to start editing it. A small action panel appears on the right side with three options:

  • Page Margin — opens a margin panel where you can set the Header from Top and Footer from Bottom distances in centimetres (cm).

    Header Footer Action Panel

  • Page Number — opens a panel to configure the page number. Set the Position (Header or Footer), Number Format (e.g. 1 of 1), and Alignment (e.g. Right). A Reset option is available to restore defaults.

    Header Footer Action Panel

  • Delete — hold to delete the header or footer from the template.

    Header Footer Action Panel

Step 1: Format the Document

Use the document toolbar at the top of the editor to format text — adjust font style, size, and colour, or insert images and tables to structure the content. You can also right-click within the document to access the same formatting options.

Document Toolbar

Learn more about toolbar features →

Step 2: Add Bookmarks (Placeholders)

Bookmarks are placeholders that get auto-filled when a report is generated. There are two ways to add them:

Method 1: Type # in the editor

Click anywhere in the document body and type # followed by the bookmark name (e.g. #patient). A dropdown list of matching bookmarks appears — select the one you need to insert at the cursor position.

Type Hash Bookmark

Method 2: Drag and drop from the Bookmark Selector

Click the bookmark icon in the top toolbar to open the Bookmark Selector panel on the right.

You can search for a bookmark by name and browse by category. Drag any bookmark from the panel and drop it into the desired position in the document.

Bookmark Selector Panel

Bookmark Types

TypeDescriptionExamples
PicklistsChoose one value from a predefined list when the report is filled inyes/no, right/left/both, normal/abnormal, none/mild/moderate/severe, positive/negative, cystic/solid/complex
FieldsPre-built text blocks and report sections that insert structured contentFindings, Impression, Indication, Description, Measurement, Disclaimer
CategoriesAuto-populated data pulled directly from the patient record and order via DICOM and FHIRPatient Name, Date of Birth, Accession #, Study Description, Referring Physician, Date/Time Ordered

For a full list of supported Category bookmarks and their descriptions, see Bookmarks reference.

Creating Custom Picklists and Fields

Custom Picklists

  1. Click the ⚙ icon next to Picklists in the Bookmark Selector to open the Customized Picklist panel.

  2. To create a new one, click the + button.

  3. In the Create New Picklist form: -

  4. Enter a List Name (required)

  5. Click + to add options to the list.

  6. Hover over an item to reveal the pin icon, then click it to set that item as the default selection.

  7. Use the trash icon to remove an item.

Custom Picklist Creation

Custom Fields

  1. Click the ⚙ icon next to Fields in the Bookmark Selector to open the Customized Field panel.

  2. To create a new one, click the + button.

  3. In the Create New Field form: - Enter a Field Name (required), e.g. Clinical History, Technique, Disclaimer.

  4. Click Create to save or Cancel to discard.

Custom Field Creation

Managing Custom Picklists and Fields

All existing picklists and fields are listed in their respective panels and can be searched. Hover over any item to reveal two options: -

- Edit (pencil icon) — update the name.

- Delete (trash icon) — permanently remove the item.
Managing Custom Picklists and Fields

Once created, your custom Picklists and Fields appear in the Bookmark Selector and can be inserted into any template or report.

Initial Cursor Position

The Initial Cursor Position is a special bookmark found under Categories in the Bookmark Selector. It defines where the cursor lands the moment a report is opened for editing — guiding the radiologist straight to the first field that needs input.

If this bookmark is not placed in the template, a warning appears when publishing: "No Initial cursor position bookmark found!"

To add it, type # in the document body and start typing Initial Cursor Position, then select it from the dropdown, or search for it in the Bookmark Selector under Categories and drag it into the desired starting location.

Initial Cursor Position

HealthCard Number / SSN Bookmark

The HealthCard Number / SSN bookmark is available under Categories in the Bookmark Selector. It auto-populates the patient's government-issued health identifier — resolving to either the HealthCard Number (Canadian provincial health insurance ID) or SSN (US Social Security Number), depending on the entity type and region.

To add it, type #HealthCard Number/SSN in the document body and select HealthCard Number / SSN from the dropdown, or search for it in the Bookmark Selector and drag it into the desired position.

HealthCard Number SSN Bookmark

Study Share URL and Study Share QR Code

The Study Share URL and Study Share QR Code bookmarks allow you to embed a direct link to the imaging study within the report. When the report is finalized, recipients can access the study directly from the PDF.

To add them, type #Study Share in the document body and select Study Share URL or Study Share QR Code from the dropdown, or search for them in the Bookmark Selector and drag them into the desired position.

Study Share URL and QR Code

How It Works

  • The Study Share URL appears as a clickable link in the report. Clicking it opens the study in a new tab.

  • The Study Share QR Code is scannable once the report is finalized and saved as a PDF.

    Study Share URL and QR Code

  • Both the URL and QR code open the study link in a new browser tab.

  • When accessed, the user must verify their identity by entering either the Patient ID or the Patient Date of Birth.

    Study Share URL and QR Code

  • Once verified, the Image Viewer opens, displaying the study.

Step 3: Page Setup

Click the Page Setup icon above the toolbar to configure how the document is printed or displayed. A panel opens on the right with the following options:

Page Setup Panel

Paper Size & Orientation

Orientation — toggle between portrait and landscape.

Paper Size — select the paper size (e.g. A4 — 21cm × 29.7cm).

Page Setup Panel

Margins (Centimetre) Set the margin distance for the Top, Bottom, Left, and Right sides of the page.

Page Setup Panel

Click Save to apply the changes or Cancel to discard.

Step 4: Preview

Click Preview to see how the template looks with all content, bookmarks, and page settings applied before publishing. This is the recommended final check before making the template available.

Preview

Step 5: Publish the Template

Once the template is ready, click the Publish Template button above the toolbar

Publish Template icon

A drawer opens on the right with the following fields:

FieldDescriptionPublish Template Drawer
Template Name (required)A unique name for the template
Organization (required)The organization this template belongs to
From Status (required)The order status this template applies from
To Status (required)The order status this template applies to
Modality (required)The imaging modality (e.g. MR, CT, US)
Body PartThe anatomical body part this template targets
LateralityLeft, Right, or Bilateral
SexFilter by patient sex if applicable
Procedure CodeAssociate a specific procedure code
Referring OrganizationThe referring facility or organization
Referring PhysicianThe referring physician
Reading PhysicianThe radiologist reading the study

Once all required fields are filled, click Publish to make the template available. Click Cancel to discard.

Editing a Template

To edit a published template:

  • Click on the template you want to edit from the Template Manager.

  • Click the pencil icon at the top right to open it in the editor.

Once open, you can modify the content directly.

Editing a Template

Custom Fields from Square Brackets

OmegaAI automatically detects square brackets [ ] in pasted content and converts them into editable custom fields.

How it works:

  • Copy content containing square brackets from your source document or text editor.

  • Paste it into the OmegaAI Document Viewer editor.

  • OmegaAI automatically recognizes each section enclosed in square brackets and converts it into a custom field.

  • These fields are editable and can be customized further as needed.

Example

Clinical: [] Comparison: [] Technique: []

Findings:[]

Impression: []

Recommendation: []

Each bracketed section becomes an independent editable field in the report.

Bookmark Reference

The following Category bookmarks are available in the Bookmark Selector. They auto-populate with data from the patient record and imaging order via DICOM and FHIR — no manual entry required.

BookmarkDescription
# of ImagesTotal number of images in the study
Accession #Unique accession number assigned to the imaging study
Account #Patient's billing account number
Account StatusCurrent billing or account status of the patient
Age at StudyPatient's age at the time the study was performed
AllergiesPatient's recorded allergies
Amendment SignatureName of the physician who amended the report, along with the date and time of amendment
Anatomic FocusAnatomical focus of the study
Assigning AuthorityThe institution that issued the patient identifier
Authorization #Authorization reference number
Authorization PeriodPeriod for which the authorization is valid
AvailabilityAvailability status of the study or result
Birth SexPatient's sex as recorded at birth
Blume Registration Page QR CodeQR code linking to the Blume patient registration page
Body PartAnatomical body part examined in the study
Cancellation ReasonReason recorded if the order or study was cancelled
CDS IDClinical Decision Support identifier
Clinical NotesClinical notes associated with the order
Communication Status NameCurrent communication or notification status
ConditionsPatient's recorded medical conditions
ConfidentialityConfidentiality classification of the report or record
Consulting PhysicianName of the consulting physician
Date of BirthPatient's date of birth
Date/Time AddendumDate and time the addendum was added to the report
Date/Time Last UpdatedDate and time the report was last updated
Date/Time ReadDate and time the study was read
Date/Time ReceivedDate and time the study was received
Date/Time SignedDate and time the report was signed
Date/Time TranscribedDate and time the report was transcribed
Date/Time VerifiedDate and time the report was verified
DepartmentDepartment that conducted the study
Diagnosis CodeDiagnosis code associated with the order
EligibilityPatient's insurance or program eligibility status
EthnicityPatient's recorded ethnicity
Exam DurationDuration of the imaging examination
Exam RoomRoom in which the examination was performed
Filler Order #Filler order reference number
Financial ClassPatient's financial classification
GenderPatient's recorded gender
HealthCard Number / SSNPatient's HealthCard Number (Canada) or Social Security Number (US)
Healthcare ServiceRoom or service line where the study was performed
HistoryPatient's relevant clinical history
Home PhonePatient's home phone number
Imaging OrganizationThe facility at which the study was performed
Insurance CopayCo-pay amount of the patient's primary insurance coverage
Insurance ExpiryExpiry date of the patient's insurance
Insurance PayerPrimary insurance company's name
Insurance StatusCurrent insurance status
Key ImagesKey images associated with the study
LanguagesPatient's preferred language(s)
LateralitySide of the body examined (Left, Right, Bilateral)
Managing OrganizationOrganization managing the patient's care
ModalityImaging modality used (e.g. MR, CT, US, CR)
Modality Modifier ArrayArray of modifiers applied to the modality
Order Custom MemoCustom memo associated with the order
Order Date/TimeDate and time the order was placed
Order IDUnique identifier for the order
Order NotesNotes associated with the order
Order Of AppropriatenessAppropriateness rating of the order
Order StatusStatus of the order
Patient AddressPatient's registered address
Patient AgePatient's age
Patient BalanceOutstanding balance on the patient's account
Patient Contact MethodPatient's preferred contact method
Patient EmailPatient's email address
Patient First NamePatient's first name
Patient IDPatient's medical record number (MRN)
Patient ID BarcodeBarcode representation of the patient ID
Patient Last NamePatient's last name
Patient LocationPatient's current or registered location
Patient NamePatient's full name
Patient State/ProvincePatient's state or province
Performing PhysicianName of the physician who performed the study
Performing Physician NPINPI identifier of the performing physician
Performing TechnologistName of the technologist who performed the study
PharmaceuticalPharmaceutical details associated with the study
Phone NumberPatient's primary phone number
Placer Order #Placer order reference number
PriorityPriority level assigned to the order
Procedure CodeProcedure code associated with the study
RacePatient's recorded race
Reading OrganizationName of the facility responsible for reading the study
Reading PhysicianName of the physician reading and reporting the study
Reading Physician NPINPI identifier of the reading physician
Reason For ExamReason the examination was ordered
Referring OrganizationName of the referring facility
Referring PhysicianName of the referring physician
Referring Physician Fax NumberFax number of the referring physician
Referring Physician NPINPI identifier of the referring physician
Reporting DetailReporting details associated with the study
Requested Appointment Date/TimeDate and time of the requested appointment
Requested Procedure IDProcedure ID of the requested study
Scheduled ResourceResources scheduled for the study
Series UIDUnique identifier for the image series
SignatureName of the physician who signed the report, with date and time
Smoking StatusPatient's recorded smoking status
SOP Instance UIDSOP instance unique identifier
Source Device AE TitleAE title of the source device
Special ArrangementAny special arrangements noted for the patient or study
Study Custom MemoCustom memo associated with the study
Study Date/TimeDate and time the study was performed
Study DescriptionDescription of the imaging study
Study IDStudy ID or reference number
Study Share QR CodeQR code linking to the study, scannable once the report is finalized as a PDF
Study Share URLClickable link that opens the study in a new browser tab
Study StatusStatus of the study
Study UIDUnique identifier for the study
SubjectSubject or topic associated with the report
Technique ObjectImaging technique parameters used in the study
Time At StatusThe duration the study or order has been in its status
Time ZoneTime zone associated with the study or order
TranscriptionistName of the transcriptionist assigned to the study
Transcriptionist OrganizationOrganization responsible for transcription
TransportTransport details associated with the patient or study
ViewView associated with the study
Visit #Visit number associated with the patient encounter
Visit ClassClassification of the patient visit (e.g. inpatient, outpatient)