QuickBooks Error OL-334 occurs when QuickBooks Desktop cannot verify your financial institution’s identity because the Bank Identification number (BID or FID) is invalid, missing, or discontinued. This error frequently appears when importing a Web Connect (.QBO) file or configuring bank feeds. It indicates that the bank ID provided in the file does not match the approved list in the QuickBooks Financial Institutions Directory (fidir.txt). To fix Error OL-334, update your local fidir.txt file or edit the bank identification numbers inside your .QBO file using a text editor.
Fast-Fix: The 45-Second Solution
To resolve Error OL-334, close QuickBooks, open File Explorer, and go to
C:\ProgramData\Intuit\QuickBooks 20XX\Components\OLB\branding\filist. Renamefidir.txttofidir.txt.old. Reopen QuickBooks and access the Bank Feeds Center; the program will automatically download a new directory file. If importing a.QBOfile, open it in Notepad and verify the<INTU.BID>tag contains an active 4- or 5-digit number.
Quick Status & Triage Snapshot
- Data Risk Tier: Low. Error OL-334 is an identity validation error. No transactions in your existing registers are modified or corrupted.
- Multi-User Impact: Isolated to the user performing online banking setup or importing statement files. All other accounting operations continue without interruption.
- Common Trigger: Financial institution mergers, bank rebranding, core banking system conversions, an outdated QuickBooks installation, or improperly generated
.QBOfiles downloaded from the bank’s portal. - Estimated Fix Time: 5 to 15 minutes.
Technical Anatomy: How Bank IDs Function in QuickBooks
QuickBooks relies on a central directory of financial institutions certified by Intuit. Every participating bank is assigned a unique Financial Institution ID (<FID>) and a Bank ID (<INTU.BID>).
When you import a .QBO file or connect via Direct Connect, QuickBooks scans the header tags:
<SONRS>
<STATUS>
<CODE>0</CODE>
<SEVERITY>INFO</SEVERITY>
</STATUS>
<DTSERVER>20260315120000</DTSERVER>
<LANGUAGE>ENG</LANGUAGE>
<FI>
<ORG>MyBank</ORG>
<FID>12345</FID>
</FI>
<INTU.BID>12345</INTU.BID>
</SONRS>
[Import .QBO File] -----> Reads <INTU.BID> Tag -----> [QuickBooks fidir.txt]
|
ID Missing / Inactive
|
[QuickBooks Desktop] <--- Throws Error OL-334 <---------------+
If the <INTU.BID> is missing, reads 0000, or contains an ID number that has been retired due to a bank merger, QuickBooks rejects the file with Error OL-334 to prevent transaction corruption.
Diagnostic Flowchart: Error OL-334 Decision Path
- Determine how the error was triggered.
- Did the error occur while importing a downloaded
.QBOfile?- Yes: Inspect the file’s internal tags in Notepad (proceed to Step 2).
- No: The error occurred during active Bank Feed setup. Proceed to step 2.
- Did the error occur while importing a downloaded
- Check directory currency.
- Has QuickBooks been updated to its latest maintenance release this month?
- No: Update QuickBooks Desktop to download the newest financial institution directory.
- Yes: Proceed to step 3.
- Has QuickBooks been updated to its latest maintenance release this month?
- Inspect the financial institution status.
- Did your bank recently complete a merger, system change, or name change?
- Yes: The old Bank ID has likely been deactivated. Remap your connection to the bank’s new legal entity name.
- No: Follow the manual directory refresh procedure.
- Did your bank recently complete a merger, system change, or name change?
Differential Diagnosis: Don’t Confuse Error OL-334 With…
- QuickBooks Error OL-203: Occurs when the bank ID is recognized, but the server’s response payload has invalid formatting or illegal characters. Review QuickBooks Error OL-203: Resolving Invalid Financial Institution Responses.
- QuickBooks Error OL-301: A network or protocol failure preventing communication with the server entirely. See QuickBooks Error OL-301: Fixing Desktop Web Connect Connectivity.
- QuickBooks Error 324: The bank connection succeeds, but your specific account or card number cannot be found. See QuickBooks Error 324: Reconnecting Renamed or Replaced Bank Accounts.
Step-by-Step Repair Guide
Work through these steps to update your directory and resolve bank ID conflicts.
Step 1: Force Update the Financial Institutions Directory (fidir.txt)
If your local copy of fidir.txt is damaged or hasn’t updated automatically, QuickBooks cannot validate recognized banks.
- Exit QuickBooks Desktop.
- Press Windows Key + E to open File Explorer.
- In the address bar, paste the following path (replace
20XXwith your version year, e.g., 2024, 2025, 2026):C:\ProgramData\Intuit\QuickBooks 20XX\Components\OLB\branding\filist - Find the file named
fidir.txt. - Right-click
fidir.txtand rename it tofidir.txt.old. - Open QuickBooks Desktop.
- Go to Banking > Bank Feeds > Bank Feeds Center.
- QuickBooks will detect the missing file, connect to Intuit servers, and download the latest certified
fidir.txt. - Retry importing your file or configuring your bank feed.
Step 2: Edit Bank ID Tags in the .QBO File
Some financial institutions export .QBO files with generic or blank <INTU.BID> tags. You can correct this manually:
- Locate the downloaded
.QBOfile on your computer. - Right-click the file, select Open with, and choose Notepad.
- Use Ctrl + F to find
<INTU.BID>. - Check the number following the tag. If it is
0,0000, or missing:- Open
fidir.txt(from Step 1) in Notepad and search for your bank’s name. - Note the active 4- or 5-digit number associated with your bank.
- Alternatively, use a certified generic bank ID (such as
3000for Wells Fargo or01239for Chase) strictly to allow the file parser to clear the import gate.
- Open
- Update both the
<INTU.BID>and<FID>tags with the valid number. Example:<FID>3000</FID> <INTU.BID>3000</INTU.BID> - Click File > Save.
- In QuickBooks, go to File > Utilities > Import > Web Connect Files and select the edited file.
Step 3: Deactivate Online Banking on Old Account Profiles
If your bank changed names or merged with another institution, previous connection settings will conflict with the new bank identity.
- Go to Lists > Chart of Accounts.
- Right-click the bank account and choose Edit Account.
- Under Bank Feed Settings, select Deactivate All Online Services.
- Click Save & Close.
- Set up the bank feed again under Banking > Bank Feeds > Set Up Bank Feed for an Account, searching for your institution under its updated corporate name.
Hard Stop: When Bank IDs Are Permanently Discontinued
If your financial institution was acquired and discontinued its direct integration with QuickBooks, its original Bank ID will be removed from fidir.txt. When this happens:
- QuickBooks will reject any setup attempts using the old institution name.
- Search the Bank Feeds setup directory for the acquiring bank’s name.
- If the institution no longer supports direct QuickBooks downloads, request transactions in
.CSVformat and convert or enter them manually. - If general bank feed synchronization continues to fail across all accounts, follow Manual Fix: 5 Steps to Resolve QuickBooks Bank Feeds Not Updating.
Closing the Books
QuickBooks Error OL-334 is an identity matching issue that occurs when bank directories or files fall out of alignment. Refreshing the fidir.txt directory file or correcting identification tags within your statement file allows the software to properly recognize your bank and resume normal transaction imports.