Skip to content

Form Error Message

This field type allows you to detect and handle error messages that appear on the page after form submission. It works similarly to Form Error Response, but does not check URLs.

Key Difference

Unlike Form Error Response, this field type:

  • Does NOT use "Error Page URL" option
  • Does NOT use "Match URL Types" option
  • Works on the current page without URL validation

🎯 When to Use

Use this field type when you want to:

  • Detect error messages that appear on the same page (no redirect)
  • Handle multiple error messages in different locations on the page
  • Stop or save the entry based on error detection
  • Use it as a field within your form configuration

Multiple Error Messages

If multiple error messages can appear in different locations on the page, this field type can match any of them regardless of their position.

⚙️ Field Options

OptionDescription
Error Response TypeThe type of error message that appears on the page
Enter Error MessageThe error message to match after form submission
Entry Action TypeWhat to do when error is detected (stop or save)
Delay Time Before Run ActionTime delay before the action is executed
ActionAction to execute when the error response matches

📋 Additional Options

OptionDescription
If excel data is not found then don't execute the actionPrevents action execution when Excel data is empty
If last excel entry completed then don't execute the actionPrevents action execution after the last entry is completed
If there is no Excel data, update only scraper data in ExcelSaves only scraped data when no Excel template is used
Can error message be anything in this elementMatches any message in the given element (useful for dynamic messages)
Remove excel column value from current entry?Removes column value from current entry after processing
Set custom message after error message matched?Sets a custom short message instead of the full error message

🔍 Error Response Type

Choose how the extension should detect the error response:

1. Matching Message In Page

Searches for the error message anywhere in the page content.

Options:

  • Message Selector Query (optional): Limit the search to a specific element
Error Message in Page

Multiple Locations

This is especially useful when error messages can appear in different locations on the page. The extension will search the entire page by default.

2. Matching Message In Browser Alert

Detects error messages that appear in JavaScript alert dialogs.

TIP

Enable Hide JavaScript Dialog in settings to automatically handle alerts.

Alert Dialog

3. Matching Message In Page Element Value

Checks for the error message in a form field's value (e.g., input box).

Required:

  • Message Selector Query: The selector of the input element
Element Value

4. Checking Element Exists In Page

Marks entry as having an error when a specific element appears on the page.

Required:

  • Message Selector Query: The selector of the element to check

Important

The element should NOT be present before submission and should only appear after an error occurs.

📝 Enter Error Message

Enter the error message(s) to match. You can add multiple messages - if any matches, the extension will handle the error according to your Entry Action Type.

Features:

  • Support for multiple messages
  • Dynamic message support using variables
  • Partial message matching

Example:

Error Messages
Dynamic Error Messages

Use Excel column variables in your error messages:

Error: {$Email$} is already registered

Or use partial matching:

already registered

This will match any error message containing "already registered".

Pre-existing Error Messages

If an error message is already present on the page before form submission, the extension will detect it and will not fill the entry to prevent duplicate submissions.

🎬 Entry Action Type

Choose what happens when an error message is detected:

1. Stop Entry

  • Stops processing the current entry
  • Entry is NOT marked as saved
  • Useful when you want to manually fix the issue

2. Save Error in the Entry Data

  • Marks the entry as saved
  • Stores the error message in the Excel entry
  • Continues to the next entry
  • Useful for logging errors and reviewing later

⏱️ Delay Time Before Run Action

Set a delay (in milliseconds) before executing the action.

1 second = 1000 milliseconds

🚀 Action

Choose what happens after the error message is matched:

  • Redirect to Page - Navigate to a different page
  • Re-Execute Form - Fill the form again (useful for retrying)
  • Click on Button - Click a specific button element
  • Page Reload - Reload the current page
  • Execute Segment - Run a specific segment of fields

⚠️ Important Notes

Critical

When you use this field type, all fields below it will NOT execute. Always place this field type at the end of your field list.

Execution Flow:

Field 1 ✅ Executes
Field 2 ✅ Executes
Field 3 ✅ Executes
Form Error Message ✅ Executes & Detects Error
Field 4 ❌ Does NOT Execute
Field 5 ❌ Does NOT Execute

💡 Use Cases

Handling Variable Error Locations

If your form shows errors in different places depending on the error type:

Login Error: Top of page
Validation Error: Next to field
Server Error: Modal popup

This field type can detect all of them without specifying exact locations.

Logging Errors for Review

Set Entry Action Type to "Save Error in the Entry Data" to:

  1. Continue processing all entries
  2. Mark entries with errors
  3. Review and fix them later in Excel

Retry on Temporary Errors

Set Action to "Re-Execute Form" to automatically retry when temporary errors occur (e.g., network issues).

Released under the MIT License.