Customer profile fields are the fields included in the customer address form used to specify the customer's billing and shipping address at checkout. A store administrator can adjust the fields they want to include in the customer address form on the Address Fields page of the store Admin area:

  • X-Cart 5.4.x - Store Setup -> Cart & Checkout

  • X-Cart 5.5 - Store > Cart & Checkout

The Address Fields page allows the following changes:

Adding New Address Fields

To add new fields to the default customer address, do as follows:

  1. Click the "New address field" button on the Address Fields page in your store's Admin area.


    You will see a new blank line added to the list of address fields below:

  2. Use the line to specify the details of the new address field you are creating:

    • Name: Enter the field's name, as it should be visible to users.

    • Service name: Enter a service name for the field. This name will not appear in your store's user interface and will only be used to refer to this field in your store's PHP code. For simplicity, use the same value as in the primary "Name" field, but only in lowercase letters, digits, and underscore.

    • Required: Specify whether the field should be optional or mandatory for completion by users.

  3. Click the Save changes button at the bottom to add the new field to the list.

Editing Address Fields

A store admin can change the name of an address field, make a required field optional, disable fields, change their order in the profile form and delete the fields created manually.

To apply changes:

  1. On the Address Fields page, locate the field you need to edit.

  2. Make the changes you require:

    • To change the field's name, click on the current field name (the area becomes editable) and replace the field name with a new value.

    • If the field is required, and you want to make it optional, or vice versa, switch the toggle opposite the field name in the "Required" column.

    • To enable/disable a specific field, use the ON/OFF button on the line of the respective field.

    • To re-arrange the order in which the fields appear in a profile, drag and drop specific fields in the list to the positions you require. (Use the four-headed arrows in the column at the far left).

    • To delete a field, click the Trash icon opposite it.


      Note: You can delete only the fields you created manually.


  3. Click Save changes.

Related pages:


Did this answer your question?