FIND Function in ONLYOFFICE Spreadsheet Editor: Formula and Examples
Find the starting character of a case-sensitive substring inside text.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in ONLYOFFICE Spreadsheet Editor. How formula examples are checked
FIND function in ONLYOFFICE Spreadsheet Editor
Quick answer
FIND locates the first exact-case appearance of a smaller text string inside a larger one. The answer is a 1-based starting position, not the found text itself. For example, =FIND("-",A2) is expected to return 4 because the first hyphen in ORD-4821-ON is the fourth character. See the current official FIND reference.
Purpose: when this formula is useful
This tutorial covers one canonical FIND function, not a separate page for localized names, byte-count variants or aliases. Use the formula when the goal is to locate text within another cell. Keep raw source values in column A and transformed results in another column. For exact matching against full codes or full rows, consider a lookup or validation workflow instead of mistaking a substring/position operation for a complete data-quality check.
Exact syntax and argument order
=FIND(find_text, within_text, [start_num])
| Argument | Required? | Exact role | Input example |
|---|---|---|---|
find_text |
Required | Substring to seek; a quoted literal such as "-" or a cell reference. |
"-" |
within_text |
Required | Whole text or cell being inspected; not a range of unrelated row values. | A2 |
start_num |
Optional | Start searching at the chosen 1-based character index; omitted means search from the beginning. | 5 |
Official interpretation: The ONLYOFFICE FIND/FINDB reference explicitly calls FIND case-sensitive and documents #VALUE! if nothing matches. Do not confuse it with SEARCH, whose official reference says case-insensitive. FINDB is separately documented in the same help page for byte-oriented scripts; do not assume it is an alias of FIND or create a second page simply because of this shared reference.
Square brackets are documentation notation for optional parameters; do not type them into a real formula. The = sign is required for a formula in a sheet. The function name is English because these examples follow English ONLYOFFICE help.
Applicability, release evidence, and formula locale
The current English-language ONLYOFFICE Spreadsheet Editor function index and the linked function page document this function as part of ONLYOFFICE Docs Spreadsheet Editor. Both references were checked 2026-10-11 (UTC). The function help is not scoped to a numbered product build: first-supported version = UNKNOWN from this evidence. The index is not a promise that every historical Docs edition, Desktop Editors version, embedded editor or mobile app accepts the formula. No native edition/platform has been opened during this research run.
The Docs release history and the separate Desktop Editors history were consulted as version context, not as proof of a particular introduction version for this function. A Desktop release number must not be silently treated as the Docs server version. If supporting older releases, test the exact installed build and save the result before changing the wording.
For an English formula, use = plus the uppercase function name, parentheses, commas between arguments, and straight double quotes around literal strings, as illustrated in the official function-insertion guide. ONLYOFFICE lets the user choose a Formula Language and regional settings (official Advanced Settings); localized names or argument separators should be checked in the installed editor’s Function Arguments panel. Do not assume a delimiter or English spelling is universal in every locale. The examples below use English names, comma separators, 1-based character positions and plain ASCII strings; avoid date/numeric autocorrection by formatting source cells as text where appropriate.
Practice worksheet: use the same sample data for all four guides
Open a blank ONLYOFFICE workbook. In the first sheet, enter the exact raw text below into A1:A9. The examples treat these as text, not formula expressions. Keep all results in B or C so that the original values are preserved for auditing.
| Cell | Text to type (not a formula) | Why it is included |
|---|---|---|
| A1 | Source text |
Header only. |
| A2 | ORD-4821-ON |
Two hyphens, uppercase province code. |
| A3 | PO-1047-Toronto |
Case variation and a city label. |
| A4 | red-red-red |
Multiple literal matches. |
| A5 | INV|2026|0412 | Literal pipe separators (enter actual vertical bars in the cell). |
| A6 | INV-2025-0412 |
Fixed-position year field. |
| A7 | sales@Example.com |
Domain segment. |
| A8 | ABC-xyz-ABC |
Repeated uppercase substring. |
| A9 | PO-0008-WEST |
No Toronto substring. |
Important for A5: type the literal value INV|2026|0412 using normal vertical-bar characters. The | codes in the Markdown table only keep its columns aligned; do not type those codes into the spreadsheet. In A1 type Source text as a normal header. Do not copy backticks into the worksheet.
- Select a result cell outside column A; enter each formula shown below, starting with
=. - Press Enter; compare it to the expected result listed for the exact row. Expected results are calculations/logic checks, not observed output from ONLYOFFICE.
- If a result differs, check input capitalization, hidden spaces, typographic quotation marks, cell format and locale. Re-enter the formula using Formula → Function or the Function Arguments helper.
- Use Formula → Show Formulas to distinguish formulas from literal text and, if appropriate, recalculate using the Formula tab (both operations are described in the official editor instructions).
Reproducible worked examples and expected results
Use the input cells exactly as shown. Type each formula into the indicated output cell (B2:B7); leaving the originals in column A avoids accidental overwrites.
| Result cell | Formula to enter | Expected answer | Reason |
|---|---|---|---|
| B2 | =FIND("-",A2) |
4 |
First hyphen after ORD. |
| B3 | =FIND("-",A2,5) |
9 |
Second hyphen, skipping positions 1–4. |
| B4 | =FIND("ON",A2) |
10 |
Uppercase suffix begins at position 10. |
| B5 | =FIND("on",A2) |
#VALUE! |
No lowercase on: official no-match error. |
| B6 | =FIND("Toronto",A3) |
9 |
Capital-T city starts at position 9. |
| B7 | =FIND("ABC",A8,2) |
9 |
Starts after first character; second uppercase ABC starts at 9. |
How the position/occurrence reasoning was verified: these examples use literal ASCII text and independent character/substring operations. For an official expected error, such as #VALUE! on a no-match result, that classification comes from the directly cited ONLYOFFICE function documentation, not from executing the error in ONLYOFFICE. A result with a different case, extra space or character changes the test input and therefore requires a fresh expectation.
Advanced, practical workflows
Extract a purchase-order number between hyphens
The text in A2 is ORD-4821-ON. To pull out 4821, use:
=MID(A2,FIND("-",A2)+1,FIND("-",A2,FIND("-",A2)+1)-FIND("-",A2)-1)
Expected 4821 (text). The first FIND returns 4; the second, starting after position 4, returns 9; thus MID starts at 5 and extracts 9-4-1 = 4 characters. This independently calculated chain uses the separately documented MID and FIND syntax. Native nested-function calculation is untested; a missing second hyphen produces a no-match problem, not a safe fallback.
Extract a prefix
=LEFT(A2,FIND("-",A2)-1) is expected to return ORD, using LEFT to take the three characters before the first separator. For rows without a hyphen, guard the FIND failure explicitly with a checked error-handling pattern, rather than assuming it returns zero.
Edge cases, errors, and important limitations
- A case mismatch is not a near match: the official guide says
FIND("on", "ON")does not locate the uppercase text; the documented no-match result is#VALUE!. - Positions are 1-based, not Python/JavaScript zero-based. A returned 4 means the fourth character, not index 3 in a zero-based programming language.
- When
start_numis supplied, it changes where FIND begins scanning, but the returned number remains a position within the originalwithin_text, not an offset from the start. - The documentation does not establish exact handling for every zero/out-of-range start index or Unicode surrogate-pair case across versions; flag those cases for native tests. Do not generalize Excel edge-case messages to ONLYOFFICE.
- A single
FINDreturns the first qualifying match. For the second separator use its optional third argument or a nested expression as above.
Unresolved behaviour: Handling of empty find_text, invalid start_num, wildcard tokens, and non-ASCII positions not established by reviewed ONLYOFFICE help; native review required. Testing with simple ASCII strings is intentional: no assumption is made that byte-based variants, localized spellings, or Unicode indexing behave identically.
Troubleshooting checklist
| Symptom | How to diagnose it |
|---|---|
Unexpected #VALUE! |
Inspect exact case, spaces and punctuation in A; compare ON versus on. The official source confirms no-match error. |
| Wrong hyphen selected | Use the optional third argument to start after the previous delimiter. |
| Result is numeric, not text | That is normal: FIND returns the starting position. Use MID or LEFT to extract actual text. |
| Formula is shown literally | Use a leading = and verify result cell is not locked into text-only display. |
| Unicode positions differ | First reproduce with the documented ASCII set; then test your exact application build and record Unicode expectations as native-only validation. |
If the editor still disagrees with the expected ASCII outputs, first verify the current formula by selecting the result cell, then confirm each literal in A2:A9 matches the practice table. A copied formula may move references unintentionally; use anchored references only when you need them. Do not alter production data to make a tutorial example appear to pass.
Comparison with other spreadsheet programs
ONLYOFFICE and Microsoft Excel both document FIND as case-sensitive and SEARCH as case-insensitive. Microsoft explicitly describes zero-start errors and some Unicode behaviour in its own products, but those Excel-specific details are not confirmed for every ONLYOFFICE edition. See Microsoft troubleshooting and the ONLYOFFICE official FIND description.
The compatibility statement above is limited to documented function roles and English-language syntax. No Microsoft Excel, LibreOffice, Google Sheets, Apple Numbers or ONLYOFFICE comparison formula was actually run for this batch. Avoid claiming that the same error codes, Unicode positions, wildcard language, formula separators and byte-based variants are identical across products.
Related guides and site links
Only an existing source-confirmed URL is linked as a local site guide. Other named related functions are review-stage references, not claims that their pages are published or currently linked on the live website.
Official reference and verification
- ONLYOFFICE Spreadsheet Editor — function documentation
- ONLYOFFICE Spreadsheet Editor function index
- Docs release history
- Desktop Editors history
- official Advanced Settings
- documented MID
- LEFT
Verification status: Official documentation checked; example outcomes were independently reasoned or arithmetically checked where applicable. Not executed in ONLYOFFICE Spreadsheet Editor.
- No genuine ONLYOFFICE Spreadsheet Editor screenshots are included; this guide does not use mock application images.