---
schema_version: "1"
id: 1eec87d52127c95bbdb454b824bd91f052f7fc58ae5ff0ff67e2e68bd05514b3
title: Search with the Archive Agent
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/archive_o_search_with_archive_agent.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.archive_o_search_with_archive_agent.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 89953f03e7ee7dae9f7521d96ed90b0d57dc004f835e67fc5a0fde2976bb294f
description: This article provides guidelines for effectively searching for archived records using the Archive Agent in the Archive managed package. It covers the most critical step of specifying an object directly in your search phrase, how to add criteria for accuracy, and how to work within system limitations to find the records you need.
products:
  - Security
  - Salesforce Platform
release: "264"
---
# Search with the Archive Agent

This article provides guidelines for effectively searching for archived records using the Archive Agent in the Archive managed package. It covers the most critical step of specifying an object directly in your search phrase, how to add criteria for accuracy, and how to work within system limitations to find the records you need.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-own_from_salesforce-264-0-0-production-enus/8ac98673-ede2-4046-a41e-2d5c846f24ff/images/icon_note.png)

Note This content relates to Archive. For Salesforce Archive, see [Store Data Externally with Salesforce Archive](https://help.salesforce.com/s/articleView?id=xcloud.archive_overview.htm&type=5&language=en_US).

## Retrieve Accurate Results

- Always Specify the Object at the Start of Your Query: The most important rule for a successful search is to start your query \\by specifying the object you want to search. This context helps the system understand where to look for your data. You can use either the object's name, for example, Case, Account, or its API name, such as `$My_Custom_Object__c`, at the beginning of your query.
    
    Examples:
    
    - Find Accounts Find Archived Accounts where address is in California.
    - Find archived cases where priority is high and owned by John Doe.
    - Search for archived `Project__c` with name.
    - Find archived opportunities which are owned by John Doe and their created date was between Jan 2024 and June 2024.
- Phrase Your Search Queries for Accuracy: The way you phrase your search queries can significantly affect the results. Use clear and specific language to ensure the Archive Agent understands your criteria.
- Combine Criteria: Use logical operators like `AND` and `OR` to combine multiple criteria.
    - The `OR` operator can be used only within a specific filter.
        
        Example: Search archived cases where case origin is email or web.
    - The `AND` operator can be used only between filters.
        
        Example: Search archived cases where priority is high and case origin is email.

## Work Within the System's Limitations

- Maximum Records Returned: The Archive Agent only displays a maximum of 100 records in the results list for any single query.
- Exceeding the Limit: If your search criteria match more than 100 records in Archive, you'll only see the first 100. The system doesn't display a "next page" button or indicate that more results exist.
- Refine Your Search: If you suspect your query returns more than 100 records, or if you can't find the specific record you're looking for, make your search more specific.
    - Add More Filters: Use additional fields to narrow the results.
        
        Example: Add a filter for `$Status` or `$OwnerId`.
        
        ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-own_from_salesforce-264-0-0-production-enus/8ac98673-ede2-4046-a41e-2d5c846f24ff/images/icon_note.png)
        
        Note The maximum number of filters allowed is 6.
    - Use Date Ranges: Filtering by a `$CreatedDate` or `$LastModifiedDate` range can be very effective.

## In-Depth Search on Returned Records

Once a query returns a list of up to 100 records, you can perform an additional in-depth search on that local result set. This isn't a new query to Archive but a simple text search on the data currently displayed on your screen. Use your browser's built-in find feature, Ctrl+F on Windows or Cmd+F on Mac, to quickly highlight keywords or values within the returned records.

## Key Takeaways

- Always specify the object at the start of your query.
- Use clear and specific language to ensure accurate results.
- Understand and work within the system's limitations.
- Refine your search to manage large result sets.
- Use in-depth search for additional filtering on returned records.