Find In Sharepoint Calculated Column

Simulate the SEARCH function in SharePoint Calculated Columns

SEARCH Function Simulator

What is the SharePoint SEARCH Function in Calculated Columns?

The SharePoint SEARCH function in calculated columns is a powerful tool used to find the starting position of a specific text string (substring) within another text string. Unlike its counterpart, the `FIND` function, `SEARCH` is case-insensitive, making it more flexible for many common scenarios where the case of the text being searched for might vary.

Calculated columns in SharePoint lists and libraries allow you to create formulas that derive their values from other columns in the same list item. The SharePoint SEARCH function in calculated columns is invaluable when you need to locate specific keywords, characters, or patterns within text fields, often as a first step before extracting or manipulating parts of the string using functions like `MID`, `LEFT`, or `RIGHT`.

Who should use it? Anyone working with SharePoint lists or libraries who needs to perform text manipulation based on the location of a substring. This includes SharePoint administrators, developers, power users, and site owners who manage data and want to automate data processing or display based on text content.

Common Misconceptions:

• It’s the same as FIND: While similar, `FIND` is case-sensitive, while `SEARCH` is not. Choosing the right one depends on whether you need case-sensitive matching.
• It extracts text: `SEARCH` only returns the starting position (a number) of the found text, not the text itself. You need other functions like `MID` to extract it.
• It can search across items: Calculated column formulas, including `SEARCH`, operate only on data within the *same* list item (row).

SharePoint SEARCH Function Formula and Mathematical Explanation

The syntax for the SharePoint SEARCH function in calculated columns is:

=SEARCH(find_text, within_text, [start_num])

• find_text: The text you want to find. This is case-insensitive.
• within_text: The text string containing the text you want to find. This is usually a reference to another column (e.g., `[Title]`, `[Description]`).
• [start_num] (Optional): The character position within `within_text` at which you want to start the search. If omitted, it defaults to 1 (the beginning of the string). If `start_num` is less than or equal to 0, or greater than the length of `within_text`, it can result in an error or unexpected behavior depending on the exact context within SharePoint.

The function returns the starting position of the first occurrence of `find_text` within `within_text`, beginning from `start_num`. If `find_text` is not found, the function returns a `#VALUE!` error.

Variables Table

Variable	Meaning	Type	Typical Range
find_text	The substring to search for	Text	Any text string
within_text	The main string to search within	Text (often column reference)	Any text string or column value
start_num	Starting position for the search	Number (Integer)	1 to length of within_text (or empty)

Variables used in the SharePoint SEARCH function.

Practical Examples (Real-World Use Cases)

Example 1: Finding an “@” symbol in an Email Address

Imagine a SharePoint list with a column named “Email”. You want to verify if the text in the “Email” column contains an “@” symbol and find its position.

• within_text: [Email] (e.g., “user@example.com”)
• find_text: “@”
• Calculated Column Formula: =SEARCH("@", [Email])
• Result: If [Email] is “user@example.com”, the formula returns 5. If “@” is not found, it returns #VALUE!. You could wrap this in `IFERROR` to handle cases where “@” is missing: =IFERROR(SEARCH("@",[Email]),0) (returns 0 if not found).

Example 2: Locating a Keyword in a Description

Suppose you have a “Description” column and you want to find if the word “urgent” (case-insensitive) appears and where it starts.

• within_text: [Description] (e.g., “This is an Urgent request”)
• find_text: “urgent”
• Calculated Column Formula: =SEARCH("urgent", [Description])
• Result: If [Description] is “This is an Urgent request”, it returns 12 (the start of “Urgent”). If “urgent” (in any case) is not present, it returns #VALUE!.

How to Use This SharePoint SEARCH Function Calculator

1. Enter Main String: Type or paste the text you want to search within into the “Main String (within_text)” field.
2. Enter Text to Find: Type the text you are looking for into the “Text to Find (find_text)” field. The search will be case-insensitive, just like SharePoint’s `SEARCH`.
3. Enter Start Position (Optional): If you want to start searching from a specific character position (1-based) within the Main String, enter it here. Leave it blank or enter 1 to start from the beginning.
4. View Results: The “Result” section will update automatically.
   • Position Found: Shows the 1-based starting position of the “Text to Find” within the “Main String”. It will show “Not Found” or an error if the text isn’t present or inputs are invalid.
   • Intermediate Results: Displays the lengths of the strings and the effective start position used.
   • Visualization: The bar chart visually indicates the position where the text was found within the main string.
5. Reset: Click “Reset” to return to the default example values.
6. Copy Results: Click “Copy Results” to copy the main result and intermediate values to your clipboard.

This calculator helps you understand how the SharePoint SEARCH function in calculated columns will behave with different inputs before you apply it in your SharePoint environment.

Key Factors That Affect SharePoint SEARCH Function Results

• Case Sensitivity: `SEARCH` is case-insensitive. “text” will match “Text”, “TEXT”, etc. If you need case-sensitive matching, use the `FIND` function instead.
• Start Position (start_num): If specified, the search ignores any occurrences of `find_text` before this position. An invalid `start_num` (e.g., negative, zero, or beyond the string length) can lead to errors.
• Text Not Found: If `find_text` is not present within `within_text` (starting from `start_num`), the `SEARCH` function returns a #VALUE! error in SharePoint. This calculator shows “Not Found”. Use `IFERROR` in SharePoint to handle this gracefully.
• Empty Strings: If `find_text` is an empty string (“”), `SEARCH` typically returns 1 (or `start_num` if provided and valid) in many implementations, including SharePoint’s behavior.
• Data Types: `SEARCH` works with text data. If you are trying to search within numbers or dates, they need to be treated as text first (though `within_text` often comes from text columns).
• Combining with other functions: The result of `SEARCH` (a number or error) is often used as input for other functions like `MID`, `LEFT`, `RIGHT`, `IF`, `ISERROR`, and `IFERROR` to build more complex logic in your SharePoint calculated column FIND function or SEARCH logic.

Frequently Asked Questions (FAQ)

Q: What’s the difference between FIND and SEARCH in SharePoint?
A: The main difference is case sensitivity: FIND is case-sensitive, while SEARCH is case-insensitive. If you need to match “SharePoint” but not “sharepoint”, use FIND. If the case doesn’t matter, SEARCH is usually preferred.

Q: What happens if the text is not found using SEARCH?
A: In a SharePoint calculated column, the SEARCH function returns a #VALUE! error if the `find_text` is not found within `within_text`. Our calculator displays “Not Found”.

Q: How can I handle the #VALUE! error when text is not found?
A: Use the `IFERROR` function in your calculated column formula. For example: `=IFERROR(SEARCH(“a”, [Title]), “Not found”)` will display “Not found” instead of an error.

Q: Can I use SEARCH to find text in a Number or Date column?
A: Not directly. Calculated column formulas expect text input for `within_text`. If you reference a Number or Date column, SharePoint might implicitly convert it to text, but it’s more reliable to explicitly convert using the `TEXT` function if you need specific formatting before searching.

Q: Can SEARCH find more than one occurrence?
A: No, SEARCH only returns the starting position of the *first* occurrence it finds (starting from `start_num`). To find subsequent occurrences, you would need more complex formulas, potentially using the result of the first SEARCH as the `start_num` for a subsequent SEARCH within a more complex, less practical calculated column, or more easily with workflows/Power Automate.

Q: What if start_num is greater than the length of the main string?
A: In SharePoint, if `start_num` is greater than the length of `within_text`, `SEARCH` will likely result in a #VALUE! error because the search effectively starts beyond the string.

Q: Is the start_num 0-based or 1-based?
A: The `start_num` in SharePoint’s `SEARCH` (and `FIND`) function is 1-based, meaning the first character is at position 1.

Q: Can I use wildcards with the SEARCH function?
A: No, the `SEARCH` and `FIND` functions in SharePoint calculated columns do not support wildcard characters like * or ?. They look for the exact `find_text` string (though `SEARCH` ignores case).

Related Tools and Internal Resources