# Record.FindFirst() Method
> Version: _Available or changed with runtime version 1.0._
Finds the first record in a table based on the current key and filter.
## Syntax
```al
[Ok := ]  Record.FindFirst()
```
## Parameters
Record
Type: record-data-type
An instance of the record-data-type data type.
## Return Value
*[Optional] Ok*
Type: ../boolean/boolean-data-type
true if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.
## Remarks
This method should be used instead of Find\('-'\) when you only need the first record.
You should only use this method when you explicitly want to find the first record in a table or set. Do not use this method in combination with Repeat.. Until.
Calling FindFirst on an empty table from the ../../triggers-auto/page/devenv-onnewrecord-page-trigger causes the Business Central Server to throw an exception, and the AL execution stops. However, the client suppresses this error and does not show any error message to the user. Therefore, when using FindFirst inside this trigger, you should add code that conditionally verifies whether a record was found, and if not, notify the user with a message. For example:
```al
if not MyRecord.FindFirst then
    Error('error message');
```
## Example
This example also assumes that you have a ConfigurePost method.
```al
var
    SalesSetupRec: Record "Sales & Receivables Setup";
begin
    // Read the first record only.
    if SalesSetupRec.FindFirst then
        begin
           ConfigurePost(SalesSetupRec);
        end;
end;

```
## Related information
record-data-type
Get Started with AL<../../devenv-get-started>
Developing Extensions<../../devenv-dev-overview>
../../../administration/optimize-sql-al-database-methods-and-performance-on-server

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/record/record-findfirst-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/record/record-findfirst-method/
