Formulas output the image specific results of each of Caption Pro's various AI features, including people's names, keywords, transcripts, caption options and alt text. They also automate other outputs like plural rules and duplicating other field's contents.
You can use a formula on its own or combine several formulas with ordinary text.
Adding and editing a formula
You can add formulas to an individual image’s metadata or use them in your project metadata settings.
Click where you want the formula to appear in a metadata field.
Type
=to open the formula menu.Choose a formula and configure its options.
Insert it, then check the result for the selected image.
To change an existing formula, select it, adjust its options and choose Update Formula.
Include any spaces and punctuation you need between formulas and ordinary text.
People Formula
=people inserts the names of people identified and selected in an image.
For example:
=people at the BAFTAs.
Could produce:
Brad Pitt and Tom Hanks at the BAFTAs.
Each instance of =people has its own settings, so you can format names differently in different metadata fields.
Formatting names
Delimiter: The text between names, such as a comma followed by a space.
Final delimiter: The text between the final two names, such as
and.Sources: Which recognition sources contribute names to this formula.
Include prefix / Include postfix: Include additional information stored with a person, such as a role or player number.
Always ignore guests: Exclude guests from this formula’s output.
Always capitalize first letter: Capitalise the first letter of the output.
Remove duplicate names: Avoid repeating the same person when they have been identified through more than one source, such as face and text recognition.
Include spaces in your delimiters where needed. For example, and includes a space on each side of “and”.
Including group names
Enable Include group name to add associated group information, such as a team name.
Group information comes from the person’s face database record or the Group column in a Text Recognition list, depending on the recognition source.
The additional options control how it appears:
Option | What it controls |
Group position | Where the group appears relative to the person’s name and other included information. |
Group repeat | Whether to show it for the First person only, Last person only or All people when consecutive people share a group. |
Group Delimiter | The text separating the group from the person’s information, such as |
An example of when you might want to output the group name in a formula is when naming people from sports teams. In such an example, you might want to say:
"quarterback Cam Ward of the Tennessee Titans" or alternatively "Tennessee Titans quarterback Cam Ward". Both of these can be configured from the group settings in the =people formula
For help identifying people and correcting names, see Editing People.
Plural Formula
=plural changes wording according to the number of people in the image.
For example:
=people =plural the BAFTAs.
Configure =plural with these settings:
Setting | Value |
Singular |
|
Plural |
|
Threshold |
|
The result could be:
Brad Pitt attends the BAFTAs.
Or:
Brad Pitt and Tom Hanks attend the BAFTAs.
Counts below the threshold use the singular text. Counts at or above it use the plural text.
Always ignore guests excludes guests from the count. Keep this consistent with =people so the wording matches the names you include.
You can also leave the singular text empty to add something only when the threshold is reached—for example, you could have a plural formula output (L-R) only when more than one person is named in the image.
Original Formula
=original inserts the value a metadata field had when the image was imported into Caption Pro.
Use it when you want to keep that information and add something alongside it:
=original — Additional event information.
If you simply leave a field empty, Caption Pro automatically uses the image’s existing metadata. You only need =original when combining that information with new text or formulas.
To replace a particular piece of text within the original metadata, use a Placeholder instead. See Editing Metadata.
Duplicate Formula
=duplicate uses the current contents of another metadata field.
Choose the field you want to reference. When its contents change, =duplicate updates to reflect them.
This is useful when the same information needs to appear in more than one field without maintaining separate copies.
Caption Pro prevents circular references, where fields would depend on one another in a loop.
Keyword Formula
=keywords inserts AI-generated keywords and keywords associated with people’s records.
Its options include:
Delimiter: The text separating keywords.
AI Confidence Threshold: The minimum confidence required for an AI keyword to appear.
Maximum AI Keywords Per Image: The maximum number of AI-generated keywords included by this formula.
The maximum limits the formula’s output; it is separate from how many keywords the AI generates.
Keywords from people’s records or the group they belong to can still be included when AI Keywording is disabled. To include AI-generated keywords, enable AI Keywording and process the images.
See AI Keywords for more information about this feature.
Photographer Formula
=photographer uses an image’s camera serial number to select the photographer’s name.
Set up mappings between camera serial numbers and names, or import a mapping file. Configure a fallback for images that do not match a mapping, then check the preview.
This is useful when images from several photographers are combined in one project. The formula is commonly used in Creator / Photographer.
This formula remains a formula when you use Paste results, so it can use the destination image’s camera information.
Caption Formula
=caption inserts the output from Auto Caption.
Add it to the field where you want that caption to appear, usually Caption / Description. You can combine it with additional text if needed.
See Auto Caption and Caption Configuration for more information about this feature.
Alt Text Formula
=alt text inserts the AI-generated alt text for an image, typically into Alt Text (Accessibility).
Enable AI Alt Text and process the images to generate the content. If the formula has not already been added to the field, insert it using the formula menu.
This formula remains a formula when you use Paste results. See AI Alt Text for setup and guidance.
Transcript Formula
=transcript inserts text produced by AI Transcription from audio or video.
Enable AI Transcription and process the relevant media first. The formula can then place the transcript in your chosen metadata field.
This formula remains a formula when you use Paste results. See AI Transcription for setup.
Tabbing into a formula.
Some formula options include Cursor when tabbing in, with None, Before and After options that you can select between. This lets a user set where they want the cursor to land - relative to the formula - when tabbing into that metadata field.
This is a useful way to prevent having to click into a metadata field to change it's content, you can simply set the tab destination to be after a formula and type directly from there.
Two other formulas or helpers appear in specific workflows:
=current valueis used during bulk metadata editing to retain each selected image’s current content while adding shared text. See Editing Metadata.=sequenceis available in export filename settings. Its Start Index sets the starting number for a numbered batch. See Saving Changes to Images.
Viewing Results
You can view the resulting output of all of your formulas by selecting an image and viewing the metadata section in the bottom right of your app interface. You can switch between the "metadata" and "formula" view to toggle between the formulas and their outputs.












