SEARCH Function in ONLYOFFICE Spreadsheet Editor: Formula and Examples
Locate a substring without requiring matching letter case.
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
SEARCH function in ONLYOFFICE Spreadsheet Editor
Quick answer
SEARCH locates a substring inside text without regard to uppercase/lowercase. For A3 containing PO-1047-Toronto, =SEARCH("toronto",A3) is expected to return 9 even though the cell spells Toronto with a capital T. The answer is the original text’s 1-based position. See the current official SEARCH reference.
Purpose: when this formula is useful
This tutorial covers one canonical SEARCH 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
=SEARCH(find_text, within_text, [start_num])
| Argument | Required? | Exact role | Input example |
|---|---|---|---|
find_text |
Required | Substring to look for; may be a quoted text literal or reference. | "toronto" |
within_text |
Required | Text within which to search. | A3 |
start_num |
Optional | Start searching from this character position; if omitted, the official description says search begins at the start. | 4 |
Official interpretation: The ONLYOFFICE SEARCH/SEARCHB page prints SEARCH(find_text, within_text, start_num) but explicitly describes start_num as optional. The bracketed form above reflects that stated optionality. The same source describes case-insensitive matching and #VALUE! if not found. SEARCHB is documented as a distinct byte-oriented variant, not another page for a spelling alias.
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 | =SEARCH("toronto",A3) |
9 |
Lowercase search finds capital-T Toronto. |
| B3 | =SEARCH("PO",A3) |
1 |
Prefix begins at first character. |
| B4 | =SEARCH("-",A3) |
3 |
First hyphen is position 3. |
| B5 | =SEARCH("-",A3,4) |
8 |
Second hyphen is position 8. |
| B6 | =SEARCH("on",A2) |
10 |
Matches uppercase ON starting at 10. |
| B7 | =SEARCH("east",A9) |
#VALUE! |
No substring: documented no-match error. |
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 code between two separators
To extract the order digits 1047 from A3 (PO-1047-Toronto), use:
=MID(A3,SEARCH("-",A3)+1,SEARCH("-",A3,SEARCH("-",A3)+1)-SEARCH("-",A3)-1)
Expected 1047 (as text). The first hyphen is at 3; the second is at 8; the extracted string begins at 4 and contains 4 characters. MID has separate ONLYOFFICE documentation. This nested formula has not been executed in the native editor; if the source lacks a second delimiter, the example will need an error-handling branch.
Explicitly distinguish SEARCH from a validation rule
=SEARCH("on",A2) is expected to return 10 for the uppercase ON suffix, while =FIND("on",A2) is documented to produce #VALUE!. Use the right function for your desired case policy; neither formula verifies a whole-cell exact match.
Edge cases, errors, and important limitations
- SEARCH is not case-sensitive according to ONLYOFFICE; do not use it to enforce uppercase-only product codes.
- No match yields
#VALUE!per ONLYOFFICE. Add a deliberate error-handling branch only if your use case legitimately treats missing text as normal. - Third argument optionality is stated in official prose even though the printed syntax lacks brackets. Do not present
start_numas mandatory. - The position is within the original string, not a relative offset from
start_num; positions of surrogate-pair characters in non-ASCII strings are unverified.
Unresolved behaviour: Wildcard handling, exact empty string behavior, start_num out of range, desktop/mobile parity and Unicode position accounting not established for ONLYOFFICE. 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 |
|---|---|
#VALUE! |
Search the exact string for an absent city or separator. The official function says no match causes this error. |
| Text exists but returned position surprises | Count characters from 1, including hyphens and spaces. |
| I need matching uppercase letters | Use case-sensitive FIND, not SEARCH. |
| A wildcard-looking formula behaves differently | Remove wildcards; match a literal substring and verify wildcard support on installed ONLYOFFICE build. |
| A nested MID calculation errors | Check for both delimiters and validate each SEARCH call separately. |
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
Microsoft Excel documents case-insensitive SEARCH and, additionally, wildcard handling using ?, *, and ~. ONLYOFFICE explicitly documents case insensitivity, but its inspected function page is silent about wildcard tokens. Therefore basic ASCII literal-search syntax is comparable; wildcard equivalence, Unicode positions and error details beyond no-match are not assumed. See Microsoft SEARCH reference and ONLYOFFICE SEARCH reference.
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
FIND (case-sensitive counterpart), MID, LEFT, and IFERROR are relevant software-specific guides in the review workflow. Existing owner-source-confirmed site guide: COUNTIF helps count cells meeting a condition, a different task from finding characters in one cell.
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
- ONLYOFFICE documentation
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.