Knowledge BaseMasterCities
Guide

Managing Cities

The Cities section allows administrators to create and manage city records used throughout the TextGem platform. Cities are linked to their respective states and countries, ensuring consistent location data for customers, users, and other system modules.

Managing Cities Overview

The Cities page displays all configured cities along with their associated Country ID and State ID. Administrators can quickly search for cities, add new entries, edit existing records, or remove outdated information.

Maintaining an accurate list of cities helps standardize location information across the application.

City List

The city table provides an overview of all available city records.

Available Information

Each city record includes:

City Name
Country ID
State ID
Available Actions

If no cities have been added, the table will display a “There are no records to display” message.

Search Cities

Use the Search Cities field to quickly locate a specific city.

How to Search

Click inside the Search Cities field.
Enter the city name.
Matching records will automatically appear in the list.

Benefits

Find cities quickly
Reduce manual searching
Improve administrative efficiency

Editing a City

Existing city information can be updated whenever required.

To Edit a City

Locate the city in the list.
Click the Edit icon in the Action column.
Update the necessary information.
Save the changes.

Deleting a City

Administrators can remove city records that are no longer required.

To Delete a City

Locate the city record.
Click the Delete icon.
Confirm the deletion.

Important: Deleting a city may affect records associated with that location. Ensure the city is no longer in use before removing it.

Best Practices

Add cities only after the corresponding country and state have been created.
Verify city names before saving to avoid duplicate records.
Keep city information consistent with official geographic names.
Remove obsolete or duplicate city entries to maintain clean location data.
Periodically review city records to ensure data accuracy.

Adding a New City Overview

Use this page whenever you need to add a new city to the TextGem system. Before creating a city, ensure that the corresponding country and state have already been configured.

After the required information is entered and saved, the city becomes available throughout the application wherever city selection is required.

City Information

The form contains the following fields:

Name

Enter the official name of the city.

Example:

Ahmedabad
Mumbai
Surat

City Code

Provide a unique code to identify the city.

Example:

AMD
MUM
ST01

Using unique city codes helps simplify identification and reporting.

Country

Select the country to which the city belongs.
The available countries are displayed in the dropdown list. Only configured countries can be selected.

State

Select the state associated with the selected country.
The state dropdown displays available states based on the selected country.

Saving the City

After entering all required information:

Verify the city details.
Click the Save button.
The city record will be created successfully.
The newly added city will appear in the Cities list.

Canceling the Operation

If you do not want to create the city:

Click the Cancel button.
Any unsaved information will be discarded.
You will be returned without creating a new city.

Validation

Before saving, ensure that:

The city name is entered.
A unique city code is provided.
A country is selected.
A state is selected.
The city does not already exist in the system.

Best Practices

Use official city names for consistency.
Assign unique and meaningful city codes.
Verify the selected country and state before saving.
Avoid creating duplicate city records.
Review all information for accuracy before submitting the form.