Admin – Error Messages Documentation
Table of Contents
1. Introduction
2. Global Validation Messages
3. Admin
4. Location Management
5. Import
6. Stockists / Dealer Form
7. Setting > General
8. Setting > Customize / Design
9. Payment
1. Introduction
This document lists all error messages displayed in the Store Locator App, including:
The root cause of each error
The exact message shown on the UI
Clear instructions for how to fix
Associated screenshots for Support
2. Global Validation Messages
Certain validation messages appear across multiple modules. They follow common input rules:
Message | Meaning / Cause |
“Please enter a value.” | Required field left empty |
“The value is not a valid email address.” | Invalid email format |
“The value must not be negative.” | Negative number not allowed |
“The value is not an integer.” | Invalid integer format (letters, decimals, trailing comma, etc.) |
“Comma ( , ) cannot be placed at the end of the value.” | Trailing comma detected |
3. Dashboard
3.1. Store Locator URL Suffix Missing
Root Cause | Error Label | How to fix |
URL suffix is empty. A suffix is required to generate a valid Store Locator URL. | “Please fill in suffix URL” | Enter a unique suffix before saving. |
Screenshot:
3.2. Store Locator URL Suffix Already Exists
Root Cause | Error Label | How to fix |
Suffix is already used by another page. | “Suffix URL is existed with another page” | Enter a unique suffix not used elsewhere. |
Screenshot:
4. Store Locations
4.1. Store Name Required
Root Cause | Error Label | How to fix |
The Store Name input field is empty. The system requires a name for each store to identify and display it properly. | “Please enter a value” | Enter a valid name in the Store Name field before saving the store details. |
Screenshot:
4.2. Email Format Error
Root Cause | Error Label | How to fix |
The value entered in the email field does not match a valid email address format (e.g., missing “@” or domain). | “The value is not a valid email address” | Enter a valid email address in the correct format (e.g., [email protected]) before saving or submitting the form. |
Screenshot:
4.3. Store Website Format Error
Root Cause | Error Label | How to fix |
The value entered in the store website field is not a valid URL. The system requires the URL to start with | “The website address is not valid. Must start with http://” | Enter a valid website address that begins with |
Screenshot:
4.4. Address Required
Root Cause | Error Label | How to fix |
The Address 1 field is empty. The system requires a primary address for each store to identify its location correctly. | “Please enter a value” | Enter a valid address in the Address 1 field before saving the store details. |
Screenshot:
4.5. Operating Hours Period Conflict Error
Root Cause | Error Label | How to fix |
Two or more time periods for the same day are identical or overlapping. The system requires each time period within a day to be unique to avoid scheduling conflicts. | “Period must be different from each other.” | Ensure that all operating hours for a single day are different and do not overlap. Adjust the time periods before saving. |
Screenshot:
4.6. Operating Hours Limit Error
Root Cause | Error Label | How to fix |
The maximum number of allowed time periods per day (3) has been reached. The system does not permit adding more than 3 operating hours for a single day. | “Max 3 timings per day have been reached.” | Remove an existing time period or adjust the schedule before adding a new operating hour for the day. |
Screenshot:
5. Import
5.1. API Key Configuration Error – Missing Key
Root Cause | Error Label | How to fix |
API key not configured. | “API keys with referrer restrictions cannot be used with this API” | Add valid Google Maps API key in Settings → Google Maps API. |
Screenshot:
How to fix - Screenshot:
5.2. Invalid File Format Error
Root Cause | Error Label | How to fix |
The uploaded file is not in the required .csv format. | “The file you uploaded is invalid. Please try again.” | Upload a valid CSV file
Export the sample CSV template → fill in your data → upload the completed file. |
Screenshot:
Fix Instruction Screenshot:
5.3. Missing Required Columns Error
Root Cause | Error Label | How to fix |
Required columns (Store Name or Store Address) were not selected in the Data Preview step. | “We could not find the Column [Store Name] and [Store Address]; they are required to import a store. Please choose from the columns below by clicking on the headers and mapping your data to the corresponding names.” | Select both Store Name and Store Address columns in the Data Preview step. |
Screenshot:
Instruction Screenshot:
5.4. Missing Required Values
Root Cause | Error Label | How to fix |
Missing Store Name or Address column. | “X Missing fields under Store Name*”
“X Missing fields under Store Address*” | Map both required columns. |
Screenshot:
Instruction Screenshot:
5.5. Google API Key Domain Restriction
Root Cause | Error Label | How to fix |
The Google API key is restricted but does not include the required RosePerl domain (https://*.roseperl.com/). | “Import stopped: Google Maps key restrictions blocked the process. Please add our domain (sl.roseperl.com) to your allowed domains list to continue.” | Go to Google Cloud Console → API Key → Application restrictions. Add https://sl.roseperl.com/* to the list of allowed domains. Save the changes and try importing again. |
Screenshot:
Instruction Screenshot:
5.6. File Exceeds 2,000 Rows
Root Cause | Error Label | How to fix |
The uploaded CSV file contains more than 2,000 rows, exceeding the processing limit enforced by the restricted Google Maps API key. | “Import stopped: Google Maps key restrictions blocked the process. Please remove the restrictions or split your file (≤2,000 rows each) and try again.” | Split the CSV file into smaller files, each ≤ 2,000 rows, then import them one by one.
Or, if possible, remove API key restrictions to allow importing the full file at once. |
Screenshot:
Fix Instruction Screenshot:
Root Cause | Error Label | How to fix |
The Google Cloud Project associated with your API key does not have Billing enabled. Many Google APIs require an active billing account to function. | “You must enable Billing on the Google Cloud Project.” | Enable Billing for the Google Cloud Project linked to your API key. You can do this in the Google Cloud Console. After enabling billing, retry using the API. |
Screenshot:
5.8. Google Cloud API Unenable
Root Cause | Error Label | How to fix |
The Google Cloud Project associated with your API key does not have all the required APIs (e.g. Maps JavaScript API, Geocoding API, Places API, Place Autocomplete API, Distance Matrix API, Geolocation API) enabled. When a request calls an API that is not enabled, Google rejects it. | “The file you uploaded is invalid. Please try again.” |
|
Screenshot:
5.9. Invalid Operating Hours Format
Root Cause | Error Label | How to fix |
One or more rows in the imported file contain Operating Hours data in an invalid format. The system expects operating hours to be provided in a valid JSON structure. If at least one row has an incorrect format, the import process cannot complete successfully. | “To save this data, please fix the errors listed below:
|
|
Screenshot:
6. Stockists / Dealers Form
6.1. Stockist Form URL Suffix Error
Root Cause | Error Label | How to fix |
The user attempted to change the Stockist Form URL without entering a suffix. The system requires a suffix to generate a valid URL. | “Please fill in suffix URL” | Enter a valid and unique suffix in the URL suffix field before saving or changing the Stockist Form URL. |
Screenshot:
6.2. Stockist Form URL Suffix Duplicate Error
Root Cause | Error Label | How to fix |
The URL suffix entered for the Stockist Form already exists and is associated with another page. Each Stockist Form must have a unique suffix to avoid URL conflicts. | “Suffix url is existed with another page” | Enter a unique suffix for the Stockist Form URL that is not already used by another page. Check existing suffixes before saving to prevent duplication. |
Displayed Error:
6.3. Recipient Email Error
Root Cause | Error Label | How to fix |
The Recipient Email field is empty. The system requires an email address to send notifications or messages correctly. | “Recipient email address is required” | Enter a valid email address in the Recipient Email field before saving or submitting the form. |
Displayed Error:
6.4. Recipient Email Format Error
Root Cause | Error Label | How to fix |
The value entered in the Recipient Email field does not match a valid email address format (e.g., missing “@” or domain). | “The value is not a valid email address” | Enter a valid email address in the correct format (e.g., [email protected]) before saving or submitting the form. |
Displayed Error:
6.5. Header Text Error
Root Cause | Error Label | How to fix |
The Header Text field is empty. The system requires a header text to display properly on the Stockist Form submission. | “Header text is required” | Enter a valid text in the Header Text field before saving settings. |
Displayed Error:
6.6. Message Text Error
Root Cause | Error Label | How to fix |
The Message Text field is empty. The system requires content in this field to submit the Stockist Form properly. | “Message Text is required” | Enter a valid message in the Message Text field before saving settings. |
Displayed Error:
6.7. Email Subject Line Error
Root Cause | Error Label | How to fix |
The Subject Line field in the email template is empty. The system requires a subject to send emails correctly. | “Subject Line is required” | Enter a valid subject line in the email template before saving or sending the email. |
Displayed Error:
6.8. Email Preview Text Error
Root Cause | Error Label | How to fix |
The Preview Text field in the email template is empty. The system requires a preview text to display a summary snippet | “Preview Text is required” | Enter a valid preview text in the email template before saving or sending the email. |
Displayed Error:
6.9. Email Sender Name Error
Root Cause | Error Label | How to fix |
The Sender Name field in the email template is empty. The system requires a sender name to properly identify the sender | “Sender Name is required” | Enter a valid sender name in the email template before saving or sending the email. |
Displayed Error:
6.10. Email Sender Address Error
Root Cause | Error Label | How to fix |
The Sender Email Address field in the email template is empty. The system requires a valid sender email to send emails correctly. | “Sender Email Address is required” | Enter a email address in the Sender Email Address field before saving or sending the email |
Displayed Error:
6.11. Email Sender Address Format Error
Root Cause | Error Label | How to fix |
The value entered in the Sender Email Address field does not match a valid email address format (e.g., missing “@” or domain). | “The value is not a valid email address” | Enter a valid email address in the correct format (e.g., [email protected]) before saving or sending the email. |
Displayed Error:
7. Settings > General
7.1. Store Locator URL Suffix Error
Root Cause | Error Label | How to fix |
The store locator URL suffix input is empty. The system requires a suffix to generate a valid URL for each store locator. Without it, the URL cannot be created. | “Please fill in suffix URL” | Enter a valid suffix in the store locator URL suffix input field before saving or changing the URL. Ensure the suffix is unique and not left blank. |
Displayed Error:
7.2. Store Locator URL Suffix Already Exists
Root Cause | Error Label | How to fix |
The URL suffix entered for the store locator is already in use by another page. | “Suffix URL is existed with another page” | Enter a unique suffix for the store locator URL that is not already used by another page. Check existing suffixes before saving to avoid duplication. |
Displayed Error:
7.3. Default Map Latitude Error
Root Cause | Error Label | How to fix |
The Latitude field in Default Map Location is empty. The system requires a latitude value to properly display the default map location. | “Please enter a value” | Enter a valid latitude value in the Default Map Location field before saving. |
Displayed Error:
7.4. Default Map Longitude Error
Root Cause | Error Label | How to fix |
The Longitude field in the Default Map Location is empty. The system requires a longitude value to properly display the default map location. | “Please enter a value” | Enter a valid longitude value in the Default Map Location field before saving. |
Displayed Error:
7.5. Operating Hours Period Conflict Error
Root Cause | Error Label | How to fix |
Two or more time periods for the same day are identical or overlapping. The system requires each time period within a day to be unique to avoid scheduling conflicts. | “Period must be different from each other.” | Ensure that all operating hours for a single day are different and do not overlap. Adjust the time periods before saving. |
Displayed Error:
7.6. Operating Hours Limit Error
Root Cause | Error Label | How to fix |
The maximum number of allowed time periods per day (3) has been reached. The system does not permit adding more than 3 operating hours for a single day. | “Max 3 timings per day have been reached.” | Remove an existing time period or adjust the schedule before adding a new operating hour for the day. |
Displayed Error:
7.7. Search Range Format Error
Root Cause | Error Label | How to fix |
The input ends with a trailing comma, which is not allowed. | “Comma ( , ) cannot be placed at the end of the value.” | Remove the comma at the end of the input and try again. |
Displayed Error:
7.8. Search Range Integer Error
Root Cause | Error Label | How to fix |
The search range contains values that are not valid integers or include non-numeric characters (e.g., “hh”). Search range values must be integers greater than 0. | “Search range values must be integers greater than 0.” | Enter only positive integers (e.g., 10, 20, 30) without any letters or invalid characters. |
Displayed Error:
7.9. Search Range Required Error
Root Cause | Error Label | How to fix |
The search range field is required but is currently empty, or the value ends with a trailing comma, causing an invalid format. | “comma(",") can not put at end of string and please enter a value.” | Provide at least one valid value and ensure the input does not end with a comma. |
Displayed Error:
7.10. Default Radius Required Error
Root Cause | Error Label | How to fix |
The Default Radius field is required but no value has been entered. | “Please enter a value.” | Enter a valid numeric value for the Default Radius before saving. |
Displayed Error:
7.11. Default Radius Negative Value Error
Root Cause | Error Label | How to fix |
The Default Radius field contains a negative number, but this field only accepts positive values. | “The value must not be negative.” | Enter a positive number (greater than or equal to 0) for the Default Radius. |
Displayed Error:
7.12. Default Radius Numeric Value Format Error
Root Cause | Error Label | How to fix |
The input contains non-integer entries or a trailing comma (e.g., | “The value is not an integer and the value must not be negative.” | Remove any trailing commas and non-numeric characters. Ensure each value is a positive integer (no decimals, no letters). Example valid formats: |
Displayed Error:
7.13. Number of Stores in List Required Error
Root Cause | Error Label | How to fix |
The “Number of Stores in List” field is required but no value has been entered. | “Please enter a value.” | Enter a valid number for how many stores should appear in the list. |
Displayed Error:
7.14. Number of Stores in List Negative Value Error
Root Cause | Error Label | How to fix |
A negative number was entered in the “Number of Stores in List” field, but this field only accepts positive values. | “The value must not be negative.” | Enter a value that is zero or greater. |
Displayed Error:
7.15. Number of Stores in List Integer Error
Root Cause | Error Label | How to fix |
The value entered contains invalid characters (e.g., a trailing comma like | “The value is not an integer.” | Enter a whole number without commas or non-numeric characters.
Example valid value: |
Displayed Error:
7.16. Maximum Stores Loaded Required Error
Root Cause | Error Label | How to fix |
The “Number of Stores in List” field is required but no value has been entered. | “Please enter a value.” | Enter a valid number for how many stores should appear in the list. |
Displayed Error:
7.17. Maximum Stores Loaded Negative Value Error
Root Cause | Error Label | How to fix |
A negative number was entered in the “Number of Stores in List” field, but this field only accepts positive values. | “The value must not be negative.” | Enter a value that is zero or greater. |
Displayed Error:
7.18. Maximum Stores Loaded Integer Error
Root Cause | Error Label | How to fix |
The value entered contains invalid characters (e.g., a trailing comma like | “The value is not an integer.” | Enter a whole number without commas or non-numeric characters.
Example valid value: |
Displayed Error:
8. Settings > Customize/ Design
8.1. Selected Result Border Size Error
Root Cause | Error Label | How to fix |
The Selected Result Border Size field is empty or contains an invalid value. The system requires a valid numeric value to properly display the border around selected results. | “Please enter a value” | Enter a valid numeric value for the Selected Result Border Size before saving the settings. |
Displayed Error:
8.2. Map Border Size Error
Root Cause | Error Label | How to fix |
The Map Border Size field is empty or contains an invalid value. The system requires a valid numeric value to properly display the border around the map. | “Please enter a value” | Enter a valid numeric value for the Map Border Size before saving the settings. |
Displayed Error:
8.3. Map Zoom Level Error
Root Cause | Error Label | How to fix |
The Zoom Level field is empty or contains an invalid value. The system requires a valid numeric value to properly set the map zoom level. | “Please enter a value” | Enter a valid numeric value for the Zoom Level before saving the map settings. |
Displayed Error:
9. Payment
9.1. Plan Limit Error
Root Cause | Error Label | How to fix |
The user currently has more locations than allowed for the selected plan. Downgrading to this plan is not possible without first reducing the number of locations to fit the plan limit. | “Change failed ! The plan is for 20 locations. You need to remove locations to be suitable for the plan” | Remove excess locations so that the total number of locations does not exceed the limit of the selected plan. Then retry changing the plan. |
Displayed Error:
9.2. Promo Code Error
Root Cause | Error Label | How to fix |
The promo code entered by the user does not exist in the system or is invalid. | “Promo Code not found. Please ensure you had keyed in the correct code.” | Verify the promo code entered and ensure it matches an active promo code in the system. Correct any typos and try again. |
Displayed Error:
9.3. Promo Code Expired Error
Root Cause | Error Label | How to fix |
The promo code entered has expired and is no longer valid for use. | “Promo Code not found. Please ensure you had keyed in the correct code.” | Check the promo code’s validity period and enter a currently active promo code. |
Displayed Error: