Last date modified: 2026-Apr-16
FOIA Admin (Advanced Access)
The FOIA Admin portal provides tools for configuring agencies used in workflow steps, defining case number formats, setting working days, and managing form templates.
Table of Contents
| Agency portals | Public portal | Agency administration |
|---|---|---|
| FOIA Portal |
FOIA Portal Settings
FOIA Portal settings give each agency the ability to customize the information they present and collect throughout FOIA workflow steps. The FOIA Portal is specific to the agency accessing it. Highlights include:
- Portal Status—displays if the agency information is visible to other agencies and the public in forms and templates.
- Public Agency Profile—displays agency information including processing times and specialties.
- Submission Form—allows the agency to add, edit, or remove fields on the public-facing submission form.
To change the agency status, information, or submission form fields, click Edit Configuration.
Portal Status
This option is enabled by default. When disabled, the agency's information is hidden from other agencies and public users. You cannot submit new requests to the agency or view past requests in the reading room. To disable the portal status, slide the Intake Portal toggle to the left.
Public Agency Profile
Use the fields in this section to provide information about the agency, its typical processing times, and any specialties the agency handles. Fields include:
- Full Agency Name—this is the name that appears in public-facing forms and templates.
- Acronym—specific to the agency.
- Description—provides insight to who the agency is and what they do.
- Agency Website—the URL for the agency's website.
- Mailing Address—the mailing address for the agency.
- Phone—the public contact phone number for the agency.
- Processing Time—lists typical processing times. You can enter multiple time frames, for example, processing time for simple versus complex requests.
- Specialties—enter the agency’s specialties. Specialties are short, descriptive keywords or subject‑matter tags that define an agency’s primary areas of focus or the types of records it handles. Enter a specialty and then press <ENTER> to save it.
Submission Form
The submission form is the primary means for users to submit new records requests. Since users can select an agency for processing their request, it's beneficial for the agency to customize the fields to meet agency requirements.
The submission form has predefined sections, which you cannot remove, but you can rename. Each section begins with a section label and then help text which provides a description for the section and any special instructions. Default fields have limited editing options; custom fields are fully controlled by the administrator.
Default sections and fields are:
Contact Information
- Section Label (cannot be hidden)
- Help Text (cannot be hidden)
- Intake Source
- First Name
- Last Name
- Your Organization
- Email Address
- Phone Number
- Fax Number
- Mailing Address 1
- Mailing Address 2
- City
- State or Province
- Zip or Postal Code
- Country
Request Information
- Section Label
- Help Text
- Case Narrative
- FOIA Team Notes
Fees & Fee Waiver
- Section Label
- Help Text
- What type of requester are you?
- Fee Amount Willing to Pay
- Request a fee waiver
- Fee waiver justification
Expedited Processing
- Section Label
- Help Text
- Request expedited processing
- Justification for expedited processing
Additional Information & Attachments
- Section Label
- Help Text
- Attachments
Review & Submit
- Section Label
- Help Text
- Review
Editing a field's properties
Click the field name to open the properties. Editing default field properties is limited to:
- Label—the field name that appears on the form.
- Required—to require a field, slide the toggle to the right.
- Help Text—provide instructions to users on the kind of information you are expecting for the field value.
- Character Limit—limit the number of characters the requester can enter.
Adding a new field
To add a new field, click the +Field button at the bottom of the target section.
Complete the field properties:
- Label—the field names displayed on the form.
- Field Type—select from the drop-down menu options.
- Required—slide the toggle to the right if this field is required.
- Help Text—enter a brief sentence to let users know what kind of answer you are expecting.
The field list now displays the custom field, along with a tag that indicates it's custom and not part of the default fields.
Deleting custom fields
While you cannot delete default fields, you can delete custom fields. Click the field name to open the properties. Click the Delete Custom Field button below the properties.
Audit Log & Activity History
Audit log and activity history will be available at GA.
Case Tracking Number Configuration
You can change the formatting of case numbers assigned to FOIA requests to customize them for your agency.
- Click Edit Format.
- Current Format Preview—you can view the case number format as you go. Each time you make a change, the preview updates with the new configuration. If you need a reminder on the case number settings before you made any changes, navigate to the Current Configuration Summary at the bottom of the screen.
- Component Ordering—change the order of the case number components. By default, the order is Static Text - Year - Sequence. To change the order, click a component, then use the arrows to move it up or down. The preview pane displays your changes in real time.
- Delimiter—by default, a hyphen separates the case number components. Select (none) from the Delimiter drop-down menu to remove the hyphen.
- Component Configuration—configure the component values for your case number, along with a starting number and how often the number sequencing should reset.
- Static Text—this value is often used as a prefix to the case number. You can set this to any meaningful value you like, along with changing its order (see Component Ordering).
- Year—set the year format to two or four digits.
- Starting Number—set the starting number for case number. This is the first number in the sequence. You can specify how often the sequence resets in the Reset Frequency setting.
- Field Length—set the number of digits for case numbers.
- Reset Frequency—use this value to specify how often the numbering sequences reset back to the starting number. You can set it to yearly, quarterly, monthly, or never.
Current Configuration Summary—this section displays the case number formatting before any changes are made. You can use this information as a reference when making changes. - Click Save & Activate to save your changes.
Working Days Configuration
Set your standard working days and hours for FOIA processing. Federal holidays are automatically applied to the working days schedule, but you can add other days as well.
- Click Edit Configuration.
- Working Hours—set the ending time and zone for FOIA processing.
- Federal Holidays and Non-Working Days—federal holidays are applied by default. Click the delete icon to remove a predefined holiday. Click Add Holiday to add other non-working days to your schedule.
- Click Save to commit your changes.
Letter Template Management
RelativityOne FOIA provides form templates that help your agency communicate with the public and other organizations. These templates are fully customizable, allowing you to edit and tailor them to your agency’s requirements. Each form template includes two types of prompts: one that you select and replace with your own content, and the other that indicates a merged field where Relativity merges data from the FOIA request directly into the form.
Prompts will appear in one of the following formats:
- <***ABC***>—indicates data that you must provide. Replace the prompt with content specific to your request.
- [ABC]—indicates merged content that is pulled directly from the pre-existing record. Relativity populates these prompts for you.
The Templates browser is located in the left-side column on your screen. If you do not see the browser panel or browser icon, make sure you are on the Letter Template Management tab. If the browser panel is collapsed, click the browser icon to expand it.![]()
To edit a form template:
- Select a template from the Templates browser. The form content appears in the preview pane.
- Click the Edit icon (it looks like a pencil) located in the upper right corner of the preview pane.
- Edit the text as needed. Click Save when you are done.
To insert a merged field:
- Click the Insert Merge Fields button at the top of the template content. A list of available fields appear.
- Select the fields you want to insert, and click Insert.

To insert a prompt:
- Place your cursor in the prompt location.
- Type <***PROMPT***>, replacing PROMPT with a brief annotation or keyword describing what the user should enter. If you have more than one word, use underscores to separate the words. For example, <***ENTER_YOUR_PETS_NAME***>. As you close the angle brackets, the prompt becomes highlighted, making it easy to see.

Adding a custom template
While the default email templates promote consistent communication, there may be times when you need to further tailor that communication to meet specific policies. In those cases, you can create custom templates and save them for repeated use.
To create a custom template:
- Click the Add icon in the Templates browser.

- Complete the following fields:
- Template Name—give your template a descriptive and meaningful name so that you can easily search for it later.
- Template Description—provide a description of the template, its intended use, and audience.
- To—Relativity provides a merged-field suggestion for this field, but you can provide your own prompt if you prefer. For example, <***ENTER_EMAIL_ADDRESS_HERE***>.
- CC—add a merged field or your own prompt.
- Subject—Relativity provides a merged-field suggestion for this field, but you can provide your own prompt if you prefer. For example, <***IMPORTANT!_PLEASE_READ***>.
- Template Body—use merged fields and prompts, along with your own content to custom the message.
- Click Save to save your template.
Agency & Component Configuration
Configure agency information and contacts to use in FOIA workflow steps.
To add a component to an agency:
- Click the arrow to the left of an agency's name to expand its properties.

- Click Add Component.
The component card opens at the bottom of the agency tier. - Enter the Name.
- Enter a Description.
- Enter the Phone number.
- Enter a contact Email address.

- Click Save Component.
To delete any of the components, teams, or users, click the ellipses on the right side of the card and select Delete.
Other options include:
- Add Team—add a team under the component. You can then add Relativity users or external users to the team.
- Add Relativity User—select a Relativity user from a list.
- Add External User—add additional external users. Click Add External User, then complete the Name, Title, Email, and Phone fields.
On this page