Last date modified: 2026-Jun-12
aiR Custom analysis (Advanced Access)
Advance Access (AA) is an opportunity to evaluate and work with Relativity features prior to the General Availability (GA) release. Relativity customers typically participate in AA programs on a feature-by-feature basis. The functionality described in this
Overview
We’re excited to invite you to participate in the Advanced Access (AA) program for Custom Analysis; a new RelativityOne capability that introduces unprecedented flexibility to document review and extensibility to additional legal data intelligence (LDI) use cases.
By participating in the AA program, you agree to test the Custom Analysis framework and provide Relativity with feedback so we can continue to build and improve upon this feature.
Related topic:
The Custom analysis framework
Custom Analysis introduces a flexible framework for designing and executing custom AI‑powered insights within Relativity. Instead of relying solely on predefined analysis types, users can create up to five Custom Analysis fields per project, each acting as an independent analysis for questions, extractions, classifications, or evaluative instructions applied to every eligible document. Custom Analysis supports both Text and Vision analysis, with each Custom Analysis field running independently across eligible documents.
Reviewers will receive per‑document outputs, dependent on their Custom Analysis prompt; delivering on the creativity and bespoke needs of our clients.
AA program plan
- AA Program Duration: The program will run from late March 2026 through late June 2026. During this time, participants will have early access to aiR Custom Analysis and the opportunity to provide feedback that will help shape the final release. Participants will have continuous access to Custom Analysis throughout the AA window.
- Deployment: The feature will be deployed to participating workspaces at the start of the AA program. There will be a 1,000 document limit per job and total 25,000 document limit per customer, and participants will not be billed.
- Data Requirements: Custom Analysis supports both Text and Vision analysis, with each Custom Analysis field running independently across eligible documents. Supported image types include native image files (JPEG, PNG, GIF).
Feedback
Your feedback during the AA program is critical to the continued development and refinement of aiR Custom Analysis. You may receive requests for feedback with your Relativity AA program contacts to share your experience and observations. During the program, we encourage you to focus your feedback on some of the following areas: Custom Analysis accuracy and relevance, impact on review efficiency, user experience and usability, and overall value and usefulness.
Your input will directly inform our roadmap and help ensure the feature delivers meaningful value upon general availability.
Help and support
If you have further questions about how this feature works or if you have issues with the feature, please contact Bryce Lew (bryce.lew@relativity.com) or Salma Kamni (salma.kamni@relativity.com).
Key features available in the Custom analysis Advanced Access program
The Custom Analysis Advanced Access Program allows users to define and manage up to five custom insights per project. Each field acts as an independent instruction, enabling customizable results across all your LDI use cases.
Custom insights
These instructions form the core logic for what the model returns for each document. Every Custom insight consists of two user‑defined components:
- Custom Insight Title—A required, unique label (up to 50 characters) that appears as a column header in the Results table and document viewer.
- Description / Prompt—A required instruction (up to 1000 characters) that tells aiR how to analyze the documents and how to present the results. Examples include summarizing information, extracting items, identifying attributes, or applying classifications. These instructions form the core logic for what the model returns for each document. For guidance on writing effective prompts, see Best practices guide for Custom insight descriptions (Advanced Access).
Behavior and output
Each field runs independently, with no cross‑field influence during AA. For every document, each Custom Analysis produces one text‑based output, which may include:
- Summaries
- Yes/No responses
- Classification labels
- Short explanations
- Identification
Managing Custom insights
Users can adjust Custom insight information at any point before running or re‑running analyses. Supported actions include:
- Editing prompt descriptions
- Deleting Custom insights
- Viewing the Custom insights in the Viewer panel next to the documents
Feature documentation
Installation
Ensure you have the aiR for Review application installed in the workspace(s) where you will be testing.
Configuration
Custom Analysis introduces a flexible but structured configuration experience that allows users to define Custom Analysis fields, set up project parameters, run analyses, and manage versions. The setup process is designed to support rapid experimentation while ensuring accuracy, defensibility, and repeatability.
The configuration workflow consists of four primary steps:
2. Creating and managing Custom insights
Setting up a project
Begin by setting up the aiR for Review project as described below.
- Navigate to the aiR for Review Project tab.
- Click New aiR for Review Project.
- Fill out the following fields on the Setup Project modal:

- Project Name—enter a name for the project.
- Description—enter a useful short description of the project.
- Data source—select the saved search that holds your document sample set. Refer to Choosing the data source for more information.
- Analysis Type—select Custom.
- Project Prompt Criteria—select one of the following:
- Start blank—select this if you plan to write new prompt criteria from scratch.
- Copy existing—select this to use a previously created set of prompt criteria in this workspace and copy it into this project for modifying as needed.
- Prompt Criteria Name—either keep the default name that automatically populated or click the pencil icon to rename it. This name must be unique.
- Custom Analysis Model—this field displays when Custom is selected for the Analysis Type. Select the analysis model desired:
- Text—run analysis on the extracted text of documents.
- Vision—run analysis on documents where their native file type is either JPEG, GIF, or PNG.
- Project Use Case—choose the option that best describes the purpose of the project. If none of the options describe the project, choose Other and type your own description in the field. It will only be used for this project. Keep this description generic and do not include any confidential or personal information. The Project Use Case field is used for reporting and management purposes and does not affect how the project runs.
- Click Create Project.
Creating and managing Custom insights
Within the Custom analysis panel, you can define up to five Custom insights that determine how aiR will analyze each document. Each field is created and edited directly within the prompt criteria pane.
Custom insight limits
- Custom insight—each Custom analysis project can include up to five Custom insights.
- Title—the insight name must be unique within the project and can be up to 50 characters. The title will act as the label for displaying results in Analysis Results tables, Custom Projects card in the Viewers, and the published output.
- Description / Prompt—the description or prompt (maximum 1000 characters) defines the exact instruction given to the model for its analysis. See Best practices guide for Custom insight descriptions (Advanced Access) for more information.
Adding Custom insights
On the Custom panel you can create new Custom insights, edit existing insight titles and prompts, and delete insights that are no longer needed.
- Enter a unique Title for the first Custom insight (up to 50 characters). It will act as the label for displaying results in Analysis Results tables, Custom Projects card in the Viewers, and the published output.

- Enter clear and descriptive instructions in the prompt text box (up to 1000 characters) that will guide aiR in analyzing documents.
- Click + Field to add more Custom Insights and repeat the above steps for each one. A maximum of five Custom insights can be added. See Best practices guide for Custom insight descriptions (Advanced Access) for more information.

- To delete a Custom insight from the list, click the vertical ellipses next to the desired title and select Delete.
- Click Save when finished adding Custom insights.
Running an analysis job
After setting up all the custom insights, you can run the analysis.
- Click Analyze [X] documents.
- Review the confirmation summary modal showing the total number of documents to be analyzed.
- Click Start Analysis.
Each Custom insight runs independently across eligible documents. Documents that cannot be analyzed will display with errors.
Viewing the results
Once the analysis completes, Custom Analysis results display as columns in the analysis results table and in a dedicated Custom Projects card within the viewer. The Analysis Results tabs displays the Control Number followed by columns labeled base don the customer field title. If you modify custom insights, change the data source, or create a new project set, only the updated insights will re-run on the next analysis. Click on the Control Number link to open the document in the Viewer.
Frequently asked questions
Q: Can I publish my results to the workspace?
A: During the AA period, publishing results is not currently supported. We anticipate this being available by the end of April.
Q: How much does it cost to run a Custom Analysis job?
A: During the AA period, you will not be charged, nor incur any additional aiR Unit usage.
Q: How can I provide feedback, or ask questions?
A: You can contact Bryce Lew (bryce.lew@relativity.com) or Salma Kamni (salma.kamni@relativity.com).