Manage Customers
Under Customers → Customers, you can find, edit, lock, and delete customer accounts. This guide covers the customer list, the address book, customer numbers and customer groups, how to reset a password, and how to log in as a customer. It also explains how the store handles guest orders and why the address verification requires a house number.
At a Glance
- Customer List: Customers → Customers displays all customer accounts. Guest customers do not have an account; their information is stored only in their orders.
- Edit: The customer profile screen has tabs for customer information, address book, payment and shipping methods, discounts, prices, and more. You can save each address individually in its respective field.
- Password: You never see a customer’s password. Using “Action,” you can send them a link or generate a link to share yourself.
- Lock: “Checkout” prevents orders from being placed from the account; “Login” locks the account entirely.
- Delete: Orders and invoices are retained. The store also deletes the address book, account balance, bonus points, shopping cart, and customer prices.
In this guide
Not covered in this guide: Registration, the login page, and personal or business accounts in the store ( Login & Registration Guide), creating customer groups and setting prices by group ( Prices & Customer Groups Guide), and creating and modifying orders for customers ( Orders Guide).
Where to Find What
You can do almost everything in the Customers menu. The settings for customer accounts are all located under Settings → Checkout → Customer Details.
| You want to… | Location in the Backend | Section |
|---|---|---|
| search for or edit a customer | Customers → Customers | Customer list |
| Create a customer manually | "Create Customer" tab under Customers → Customers | Create Customer |
| Change a customer’s address or title | Customer form, “Address Book” tab | Addresses |
| Set a new password for a customer | Customer screen, “Action” button | Password |
| View the store as the customer sees it | Action menu for the row or “Action” in the customer screen | Log in as a customer |
| Move customers to a different customer group | Customer screen, “Customer Data” tab, “Customer Group” field | Customer Group |
| Block a customer | "Account" and "Checkout" buttons in the customer list | Lock |
| Clean up accounts that haven't been used in a long time | Customers → Inactive Customers | Delete |
| Create customer groups and set prices for each group | Customers → Customer Groups | Guide to Prices & Customer Groups |
| Set Fields and Required Information for Customer Accounts | Settings → Checkout → Customer Details | Form Fields |
You can define what an employee is allowed to do in customer management using the Permissions Editor. For the “Customers” page, in addition to Read, Edit, Create, and Delete, there is the “Lock User Account” permission; see the Employees, Permissions & 2FA Guide.
The Customer List
The list under Customers → Customers displays all customer accounts. Customers who placed orders as guests do not appear here. The tabs at the top lead to “Manager,” “Partner” (once partners are available), and “Create Customer.”
The customer list under Customers → Customers: filters and live search at the top, the “Account” and “Checkout” buttons for each row, and the action menu on the right. Click to enlarge.
Search
The “Customer Number” field on the left opens the customer with that ID directly. The live search next to it finds last name, first name, company, email address, phone number, ZIP code, and customer number—including the individual one. When a comma is used, it searches for “Last Name, First Name.” It also finds an email address if it’s stored as an alternative address or as a billing address.
Filter
“All Customer Groups,” “All Customer Group Types,” and “All Account Types” narrow down the list. The number of customers is shown after each group. An account is considered a “Company” if it has the title “Company” or a company name in the customer data; the addresses are irrelevant for this purpose.
Columns
ID, Company, “Last Name, First Name,” Customer Group, Customer Group Type, “Shipping/Payment,” bonus points (if the bonus module is enabled), the “Account” and “Checkout” buttons, and “Created On.” Icons in the “Company” column indicate corporate customers, managers, and partners. A warning icon next to “Shipping/Payment” means the customer has their own payment or shipping methods.
Info icon and action menu
The info icon at the end of the row displays the customer number, creation and modification dates, last login, number of logins, orders, and reviews, email address, phone number, fax number, date of birth, as well as the default and billing addresses. The action menu next to it offers the following options, depending on permissions:
- “Edit,” “Lock Customer Account” or “Unlock Customer Account” (disables checkout; see Locking), and “Delete,”
- “Create Order,” “Orders” and “Purchased Products” for customers with orders,
- “Send Email,” “Manager,” and “Log In as Customer.”
Exporting Email Addresses
The customer list does not have its own export function. The best method depends on what you need the addresses for.
For marketing: newsletter subscribers
Under Tools → Newsletter Manager, the “Export Newsletter Subscribers” button downloads all confirmed subscriptions as a CSV file. These customers have given their consent. The Newsletter Guide describes the columns and process.
All customer accounts: the “Customer Data” Porter
Under Tools → xoPort CSV Import/Export Manager, a Porter under the “Customer Data” section exports all accounts with email addresses, physical addresses, and customer groups—for example, for accounting or inventory management. Guests do not have accounts; their addresses are listed in the order data. See the Import & Export Guide.
To send an email to an individual customer, use “Send Email” in the Actions menu—for example, to follow up on an order. This opens Tools → Send Email with the customer as the recipient.
Creating Customers in the Backend
Customers usually register themselves. For phone orders or business customers, you can also create the account in the backend.
- Under Customers → Customers, open the “Create Customer” tab.
- In the “Customer Data” tab, enter the title, first name, and last name; for the “Company” title, enter the company name. Also select the email address, customer group, and customer language. The store will send emails related to the account—such as password reset emails—in the customer’s language.
- In the “Address Book” tab, use “Add Address” to create at least one address and enable “New Default Address.” You don’t need to click the “Save” button in the address box yet for a new customer.
- Click “Insert” at the bottom. Only now will the store save the customer and addresses together.
- The new account does not yet have a password, and the store will not send an email. Use “Action” to provide the customer with a link that allows them to set their own password; see Password.
- There is one customer account per email address. If the address is already taken, the store will display the message “This email address already exists!”
- For customers without an email address, go to Settings → Checkout → Customer Details → Use Dummy Email Address and set it to
true. The “Dummy Email Address” toggle will then appear in the customer form. If it is set to Yes, the store will not verify the email address. Such customers will not receive any emails or a password reset link. - To place an order on behalf of the customer, go to “Action” → “New Order”; see the Orders Guide.
The Customer Form
The “Edit” button in the row opens the customer screen. At the bottom, click “Save and Close” or “Update” to save. The store, however, saves partner assignments, notes, and tickets immediately; this is indicated in a note on the respective tab.
| Tabs | Content |
|---|---|
| “Customer Data” | Master data, email addresses, phone number, customer number, customer group, credit balance, blocks (table below) |
| “Address Book” | All of the customer’s addresses, default and billing addresses; see “Addresses” |
| “Payment & Shipping Methods” | Custom selections for this customer, such as “purchase on account” available only to regular customers. If no selection is made, the settings for their customer group apply; if none are set there, the module’s default settings apply. |
| “Discounts,” “Prices” | Category discounts and prices per item specific to this customer; see the Prices & Customer Groups Guide |
| “Credit Account” | Credit balance history; appears as soon as there are transactions or a credit balance—see the Gift Certificates & Coupons Guide |
| “Notes,” “Tickets” | Internal notes and the customer’s tickets, depending on permissions for “Admin Notes” or “Tickets & Tasks” |
| “Appointment Overview,” “Projects” | Appointments and projects from xoCRMXONIC Premium: CRM |
| “Partner Program” | Partner settings or fixed partnerships with partners; see “Partners” |
| “Manager” | “Customer is Manager”: a buyer who places orders for customers assigned to them, with permissions and email forwarding |
| “Contracts” | When the contract system is enabled, see the Contracts & Subscriptions Guide |
The “Customer Data” tab: on the right, the email addresses, the customer’s own customer number, the customer group, and the restrictions under “Blocked for.” Click to enlarge.
The most important fields in the “Customer Data” tab
| Field | Meaning |
|---|---|
| "ID / Customer No." | The customer ID and the displayed customer number. The info icon shows when the customer was created and when their data was last updated. |
| “Title” | “Mr.”, “Ms.”, “Company”, or “Not specified”. If Settings → Checkout → Customer Details → Gender is set to “ false ”, only “Company” and “Private” are available. Selecting “Company” designates the account as a business account. |
| “VAT ID” | Displays the result of the online verification. It can be changed in the default address settings. |
| “Email Address,” “Alternative Email Address,” “Email Address (Invoice)” | See Email Addresses |
| “Customer Language” | Language for emails regarding the account, such as password emails |
| “Individual Customer Number (External)” | Your own number, such as from your inventory management system; see “Customer Number” |
| “Customer Group,” “Customer Group Type” | See “Customer Group” |
| “Customer Credit,” “of which non-transferable” | The customer’s credit balance; the second value is the portion that cannot be forwarded as a gift certificate |
| “Bonus Points” | Only with the Bonus Module; the pencil icon opens the history—see the Bonus Points Guide |
| “Locked for” | the “Checkout,” “Login,” and “Newsletter” buttons; see “Restrictions” |
| “Force Password Reset” | The next time the customer logs in, they will receive a link via email instead of their login credentials and must set a new password. |
| “Customer on the newsletter mailing list” | Indicates the newsletter subscription. Customers must sign up and consent themselves. |
Address Book, Shipping, and Billing Addresses
A customer can have any number of addresses. Two are particularly important: the default address, which the store pre-selects as the shipping address during the checkout process, and the billing address. In the “Customer Data” tab, the billing address appears only if it differs from the default address.
Change Address or Title
- Open the customer’s profile. In the “Customer Data” tab, the pencil icon next to “Default Address” or “Billing Address” opens the address; you can open any other address in the “Address Book” tab by clicking “Edit.”
- Change fields. Each address has its own “Title” (Mr., Ms., Company, None), separate from the title in the customer details.
- Use “New Default Address” or “New Billing Address” to set the address as the shipping or billing address.
- Click “Save” in the address box. The store saves this address immediately.
In the “Address Book” tab, “Edit” opens an address; “Save” in the box saves only that address. Click to enlarge.
- You can create new addresses by clicking “Add Address.” The store won’t remove deleted addresses until you click “Save and Close” or “Refresh” at the bottom.
- The default and billing addresses do not have a delete button. First, add another address.
- If an address is linked to contracts, the contracts will reflect your change. If you change the default or billing address, the shop will offer to update the contracts accordingly. You can only delete such an address after you’ve assigned the contracts to a different address.
- Existing orders retain their address. To change an address in an order, use the Order Editor; see the Orders Guide.
Can customers change their addresses themselves?
By default, yes. If a merchandise management system manages customer data, set Settings → Checkout → Customer Details → Allow customers to change their address to “ false.” Then customers cannot change addresses or personal information, nor can they delete their accounts themselves. If you enter addresses under “Emails for blocked address changes,” the store will send change requests from the customer’s account to those addresses; if no addresses are entered, the customer will only see a message instructing them to contact you.
A customer’s email addresses
An account has a primary email address and, if desired, additional ones. Each serves a different purpose.
| Field | What the store uses it for |
|---|---|
| “Email Address” | Login, order confirmation, status emails, password reset emails. There is only one customer account per email address. |
| “Email Address (Invoice)” | Any number of addresses, such as those used by accounting. If you send a status email with an invoice or invoice correction, it will also be sent to each of these addresses, including for invoices related to contracts. The order confirmation is sent only to the primary address. |
| “Alternative Email Address” | A second email address for the customer. The customer search function uses this address to find the customer, and the store uses this address to assign inquiries submitted via the store’s ticket form to the customer. It appears as a selectable recipient in the ticket. Order and status emails are not sent to this address. |
| “xoCRM: Alternative Email Addresses” | Additional contact addresses recognized by the customer search and the ticket systemXONIC Premium: CRM |
- A billing address cannot be the primary address or the primary address of another account. Otherwise, when saving, the store will display the affected address and the customer number of the other account.
- If you change a customer’s primary address, their availability alerts will update to the new address, and the store will note the change in the consent record.
- A newsletter subscription will be transferred to the new address.from 4.9.123
Customer ID
Each account has a customer ID, which the store assigns sequentially. Additionally, you can enter your own number, such as the one from your inventory management system.
Assigned by the store
The number of the next account is listed under Settings → Checkout → Number Ranges → Change Customer Number. It can only be incremented: The new value must be higher than the highest assigned ID.
Custom Number
In the “Customer Data” tab, enter up to 64 characters—including letters—under “Custom Customer Number (External).” If this is set, the customer list and customer form will display it as “Customer No.,” and emails will use it instead of the ID.
“The customer … already has this customer number!”
If Settings → Checkout → Customer Details → Use external customer number as custom customer number is set to “ true ” (default), the custom number replaces the ID on receipts as well. To prevent duplicate numbers, the store checks the following when saving: No other account may have the same internal number, and no customer ID may match it. Otherwise, the message will specify the account that already has that number.
K-10234)—or use the “Change Customer Number” option within your own number range.Customer Number on Invoices and in Emails
- Whether receipts display the customer number is controlled by Settings → Design → Receipts → Customer Number (default:
true). “Customer Number Prefix” and “Customer Number Suffix” add text before or after it. - Your own number appears on receipts if “Use external customer number as your own customer number” is enabled; otherwise, the customer ID is used. Guest orders do not include a customer number.
- To control whether status emails from the backend include the customer number, go to Settings → Checkout → Customer Details → Include Customer Number from the Store in Emails. In email templates, the placeholder
{orders:customers_id}inserts your own number or the ID.
Assign Customer Group
Each customer belongs to exactly one customer group. This determines prices, whether prices are displayed gross or net, tax exemptions, and payment and shipping methods.
Change Group
In the “Customer Data” tab, change the “Customer Group” field and save. The customer will see the new prices the next time they log in. The guide “Prices & Customer Groups” describes how to create groups and assign them automatically, while the guide “Login & Registration” covers assigning groups when companies register.
Multiple groups?
No. For a second classification—such as by industry—use the “Customer Group Type” under Customers → Customer Group Types. This is used only to filter the customer and order lists; prices are not affected by it. You can set special terms for an individual customer in the “Discounts” and “Prices” tabs.
Guests without a customer account
A guest is assigned to the group that would apply if they were to register: the group they select in the form, the only group available for selection during registration, or—if neither applies—the default customer group (ID 0, set to “End Customers” by default). If they provide a valid VAT ID, they are assigned to the “Automatic Merchant Assignment” group. This group also appears in the order. Settings → Checkout → Customer Details → Customer Group Assignment for Purchases Without a Customer Account only determines which group the store uses to save the temporary guest record; it does not change the prices during the checkout process.
The “End Customer or Reseller” preselection pop-up
With Settings → Checkout → Customer Details → Customer Group Preselection Popup at true, the store asks unregistered visitors whether they are a retail customer or a reseller. The window remains open until they make a selection. The options are the default customer group and the group under Settings → Checkout → Tax ID Validation → Automatic Domestic Merchant Assignment. You can edit the text under CMS → CMS Manager in the entry $cms_cgroup_preselect_advice. The pop-up does not appear on false (default). The “Merchant” option only works if “Selection via parameters allowed” is enabled in this merchant group, and, as with the link, it applies only up to the guest form or registration page.
A Link for Selected Customers
If you enable “Selection via Parameters Allowed” in the customer group, guests can view the prices and product range for that group via a link containing ?c_group=<ID>. However, if they place an order as a guest or register, the store will re-determine the group as described above. Anyone who knows the link will see the prices. You should therefore assign fixed terms via a customer account in the group or an access code during registration; see the Prices & Customer Groups Guide.
Password and Access
The store does not store passwords in plain text; you cannot view them. If a customer needs a new one, use the “Action” button in the upper right corner of the customer screen.
The “Action” menu in the upper-right corner of the customer screen, shown here with the manual password option (“Send password link”). Click to enlarge.
| Entry in the “Action” menu | What happens |
|---|---|
| "Generate Password Link" | The store displays a link with a copy button and does not send anything. You forward it on your own, for example, if emails from the store aren’t reaching the customer. The current password remains valid until the customer sets a new one. |
| “Send Password Link” | The customer receives an email with a link that allows them to set a new password. This is the name of the menu item when the password option is set to “ manuell.” |
| “Set and Send New Password” | This is the name of the same entry when the password option is set to “ auto ”: The store immediately generates a random password and sends it via email. The old password is no longer valid. |
| “Send welcome message including password” | Generates a new random password and sends the welcome email along with the password, just as it does after registration |
If the account has no email address, “Send Password Link” or “Set and Send New Password” sets a new password and displays it to you in the backend.
“Generate Password Link” only displays the link and does not send anything; you must forward it yourself. Click to enlarge.
How long a link is valid
By default, 24 hours; this can be adjusted under Settings → Privacy → Password Policies → Customer Password Reset: Link Validity (Hours) (1 to 168). A link works only once. A new link—whether generated, sent, or requested by the customer—invalidates the previous one. For accounts with the “Login” lock and accounts without an email address, the store does not generate a link.
Our recommendation
Use the link options. The customer chooses their own password, and it is not included in any email. The other two options send a password in plain text.
Password during registration: automatic or user-selected
Settings → Checkout → Customer Details → The “Password option during account creation” is set by default to “ auto ”: The registration form has no password field; the store generates a password and sends it via email. With “ manuell,” the customer chooses their own password in the form. The minimum length is specified under Settings → Privacy → Password Policies → Password Policies: Minimum Length.
If a customer creates an account via Express Checkout, there is no password field on the form. The customer will always receive a random password via email, even when using manuell.from 4.9.82
If the customer has forgotten their password
- They can request a link themselves by clicking “Forgot Password” on the login page. The store always displays the same confirmation message, even if no account is associated with that email address. If they request it again within five minutes, no second email is sent.
- Guests do not have an account and therefore do not receive a link; see Guests & Duplicates.
- You can change the text of the “Password Request” email under CMS → Emails & Marketing / Automations; see the CMS & Emails Guide. If no email arrives, use “Generate Password Link.”
Log in as a customer
“Log in as a customer” opens the store in a new tab, logged in as that customer, without their password. This allows you to check their prices, their shopping cart, or an error message they describe.
Where and for whom
This option is available in the Actions menu of the customer list, in the “Action” menu of the customer profile, and in the ticket view. By default, only the main administrator—that is, the user account with ID 1—can see it. For other employees, set Settings → Privacy → General → Visibility for “Log in as Customer” to true.
In addition, your user group needs read access to redirect.php,which can be configured in the Permissions Editor under “Additional Areas (without menu item).” from 4.9.24
What happens
- The store loads the customer’s saved shopping cart. Your own shopping cart in this browser is cleared.
- This login does not count as a customer login. “Last Login” and the number of logins remain unchanged.
- This does not work for accounts with the “Login” restriction.
What you’re essentially placing is a standard customer order with all emails sent to them. To place an order on their behalf, it’s better to use “New Order” in the backend; see the Orders Guide.
Changing a Customer’s Partner
With a fixed partner assignment, a partner earns commission on all orders that the customer places while logged in.
- In the “Affiliate Program” tab of the customer profile, “assigned affiliates” are listed for regular customers. Use “Add Affiliate” to assign the customer to an affiliate, and “Delete” to remove the assignment. The store saves both changes immediately.
- The new association takes effect the next time the customer logs in. You can assign orders that have already been placed to a different partner in the Order Editor.
- If you want the customer to become a partner themselves, enable “Customer is a Partner” in the same tab. For more information, see the Partner Program Guide.
Blocking Customers and Excluding Them from Orders
There are two toggle switches for blocking customers in the customer list, and the same switches are available in the “Customer Data” tab under “Blocked for.” Only users with the “Block User Account” permission may toggle these switches.
| Block | List | Effect |
|---|---|---|
| "Checkout" | "Checkout" column, "Lock Customer Account" action menu | With Settings → Checkout → Customer Details → Account Lock Type = “ checkout ” (default), the customer can still log in but cannot proceed to checkout. They see “Your customer account is locked …”. With “ login,” they can no longer log in at all. |
| “Login” | "Account" column | No login, no new registration, and no guest orders with this email address; no Express Checkout. Password reset links are not available for such accounts. |
| “Newsletter” | – | The customer does not receive newsletters; see the Newsletter Guide. |
- If you block checkout, the store will simultaneously unsubscribe the customer from the newsletter, including through any connected newsletter provider. The same applies to the “Account” button in the customer list.
- A restriction takes effect the next time the customer logs in. Customers who are currently logged in will not notice it until then.
- To restrict only specific payment methods—such as purchase on account—instead of blocking the customer: Go to the “Payment & Shipping Methods” tab, then “Select Payment Modules for This Customer.”
Guest Orders and Duplicate Accounts
Anyone who places an order without a customer account is a guest. The store creates a temporary data record for this and deletes it after the order is completed. Any remaining guest data records are removed one day later when logging into the backend; if payment is still pending, they are removed later. After that, the name, addresses, and email address are only available in the order details.
Why the store doesn’t recognize a guest
When placing the next order, a guest re-enters their information. Logging in with their email address fails, and the “Forgot Password” feature does not send them an email because no account exists. They can create an account at any time using the same email address—either during registration or by checking the box during the checkout process.
Assigning Previous Guest Orders
Under Orders → Orders, you can find all orders placed by a person by entering their email address in the search field. Selecting “Link to Customer Account” from the action menu links a guest order to the account. This process transfers the account’s address information to the order; see the Orders Guide.
Whether customers are allowed to order as guests is controlled under Settings → Checkout → Customer Details → “Registration Required During Checkout.” By default, they order as guests and can create an account by checking the box if they wish. The other options are: always with an account, only as a guest, or with an account and as a guest if desired.
Two Accounts with the Same Email Address
Registration and the customer form allow only one customer account per email address. Multiple accounts with the same address can be created, for example, using a dummy email address. It is impossible to predict which account the customer will use to log in. Here’s how to clean this up:
- Determine which account should remain—usually the one with the most orders.
- Reassign the orders from the other account using “Change Assigned Customer” in the action menu of the order overview.
- Manually transfer credit balances, bonus points, customer prices, and partner loyalty status as needed.
- Delete the redundant account. There is no merge function.
Deleting Customers
Deletion is permanent. Orders, invoices, and returns are retained, as are tickets, though they will no longer be associated with a customer.
Deleting a customer
Select “Delete” from the context menu in the customer list. If the customer has written reviews, the store will ask, “… Delete review(s) as well?” (default: Yes). If you select No, the reviews will remain but will no longer be associated with the customer. The store records the deletion in the consent log.
What the store also deletes
Address book, shopping cart, wish list, bonus points, credit balances, customer prices and discounts, notes, manager and partner assignments, a separate partner account, and the newsletter subscription. Review emails for old orders will no longer be sent.
Cleaning Up Inactive Customers
Customers → Inactive Customers displays accounts whose last login was before a certain date.
- “Show all customers who last logged in before” is preset to three months ago.
- If the “Include customers with orders” checkbox is unchecked, the list shows only customers without orders.
- In the action menu for each row: “Open Customer Account,” “Orders,” and “Delete.” Deletion is done individually, and reviews are always deleted along with the account.
- Accounts that have never logged in—not even after registration—are not included in this list. Registration itself and “Log in as a customer” do not count as logins. You can find such accounts in the customer list by sorting by “Created on” and looking for the info icon with an empty “Last Login” field.
Customers → Inactive Customers lists accounts whose last login was before the selected date. Click to enlarge.
You can specify when to delete unused accounts in your deletion policy. Orders are not tied to the account; the store deletes them only after the retention period specified in Settings → Privacy → General → Order Retention Period (default: 10 years).
Account Deletion by the Customer
In the customer account, on the personal information page, the customer will find “Delete Customer Account.” They confirm the deletion by checking the box. From that point on, their account is locked (“Login”), and they receive an email with a confirmation link. What happens when they click the link is governed by Settings → Checkout → Customer Details → Account Can Be Deleted:
| Value | Effect |
|---|---|
delete (default) | Clicking the link deletes the account. |
deactivate | The account remains locked. You delete it yourself from the customer list. |
false | Customers won’t see a delete button and will contact you. |
- If “Allow customers to change their address” is enabled at
false, the site will ask the customer to contact you to have the account deleted. - If you reactivate an account with a pending deletion request (using the “Account” button), the link in the deletion emailwill expire.from 4.9.123
Address validation: house number, ZIP code, length
The store verifies every address during registration, in the customer’s address book, and during the checkout process. It also double-checks saved addresses before the purchase is completed.
House number
The street and house number are entered in a single field. The store requires a house number for addresses in 25 European countries, including Germany, Austria, Switzerland, France, and the Benelux countries. It does not check addresses for other countries, such as the U.S., the U.K., or Greece. If the number is missing, it displays the message “Please enter a house number” or, during the checkout process, specifies which address is affected.
Zip Code
For the same countries and the United Kingdom, the store checks the postcode format—for example, five digits for Germany. If the format is incorrect, it displays the message “The postcode you entered does not appear to belong to the selected country!” It correctly recognizes British postcodes such as SW1A 1AA and Luxembourgish postcodes such as L-. from 4.9.47
Length
If a shipping interface such as DHL, DPD, GLS, UPS, or Hermes is active, the store reports fields that are too long instead of truncating them, for example, “The street name may be no more than 35 characters long …”. This also applies in the customer form. The order editor only issues a warning. Without an active shipping interface, this limit does not apply.
Why the house number message appears
| Cause | Solution |
|---|---|
| The street name contains no numbers, such as “Am Markt” or a farm name. | Add the house number. If many of your customers’ addresses lack a number, disable the validation (below). |
| An international address is listed under the wrong country—for example, a U.S. address listed as being in Germany. | Correct the country. |
| The house number comes before the street name, such as “6 Altersberger Weg.” | This is no longer a reason for the error message; in older versions, the number had to be at the end.from 4.9.21 |
| There is a comma or colon between the street name and the number, such as “Münsterweg,1”. | Enter a space instead of punctuation. |
| The error message appears during the ordering process even though the customer hasn’t entered anything. | This affects a saved address—for example, one from an import or from the customer form—that does not validate the house number. The customer can correct it in the address book, or you can correct it in the backend. |
Additions after the number, such as “(rear building)” or “2nd floor,” and a comma at the end do not interfere with the validation.
Disable validation
The settings under Settings → General → Module Options → Street/House Number Validation and … → ZIP Code Validation Based on State are visible only to the main administrator. If you do not see this settings group, Support will adjust the validation for you. Leave it enabled if possible: A missing house number will prevent a package from being delivered later.
Address Suggestions While Typing
If you enter a key under Settings → Design → General → Google Maps API Key, the store will suggest matching addresses as you enter the street, ZIP code, and city. The customer’s input is sent to Google for this purpose. Be sure to mention this in your privacy policy. Without a key, no suggestions will be provided.
Required and Additional Fields
You can configure which fields customers fill out under Settings → Checkout → Customer Details. The fields for registration, personal and business accounts, and the VAT ID number are described in the Registration & Sign-Up Guide.
| Effect | Effect |
|---|---|
| “Phone Number” | mandatory: Required field in registration, personal information, and the contact form. During the “Shipping” step of the checkout process, the store also requests this number—pre-populated from the account—and saves it there. optional: Optional. false: Hidden. This setting applies to all countries. |
| Settings → General → Minimum Values → Phone Number | Minimum length, default 5 characters |
| “Additional Address Field / Neighborhood” | true: Additional “Address Details” field in all address forms, including the customer interface |
| “Show DHL Packstation/Post Office Field” | Field for the DHL postal number when shipping to a Packstation or post office branch. In the backend, every address has this field labeled “Postal Number for Packstation/Branch.” |
| “VAT ID Required Field On/Off” | false: The VAT ID is optional. See the “Sign-Up & Registration” guide for details. |
| “Enable Customer Registration” | false: Customers do not register themselves; you create the accounts in the backend, for example, in a store exclusively for business customers. |
| “Require Login: Popup Modal in the Frontend” | Unregistered visitors see a login window that cannot be closed. |
Downloadable Items Only with a Customer Account
You don’t need to configure any settings for this. If an item with an active download file is in the shopping cart, the store will always create a customer account when the order is placed, even if you allow guest orders. The customer will see a note about this in the form. They can access their downloads through their account.
For download items, the Stripe Express Checkout displays a message instead of the payment button if the customer isn’t logged in.from 4.10
Signing in with Amazon, Google, or Apple?
There is no option to sign in with a third-party account. Amazon Pay is a payment method: The customer pays using their Amazon account; when the module is enabled, the button also appears on the sign-in page. The “Social Login Buttons (Preview, Non-Functional)” setting only displays disabled buttons for Google and Apple with the text “Coming Soon”; leave it set to “ false.”
Frequently Asked Questions
Where do I change a customer’s address in the backend?
Can I enter multiple email addresses for order emails?
How do I export the email addresses of all customers?
Why does the store report that the customer number is already in use?
How do I display my own customer number on invoices?
How do customers view their invoices in their customer account?
Can a customer belong to multiple customer groups?
Which customer group are shoppers without a customer account assigned to?
How do I disable the “End Customer or Reseller” pop-up?
How do I prevent the store from sending passwords via email?
How do I reset a customer’s password?
How do I enable “Log in as a customer”?
How do I change a customer’s affiliate later?
How do I exclude a customer from placing orders?
Why doesn’t the store recognize a customer’s email address on a follow-up order?
How do I delete inactive customers without logging in?
Why does a house number error message appear even though a number has been entered?
Can I make the phone number required for certain countries?
How do I enable an additional address line?
How do I require customers to create an account when purchasing downloadable items?
How do I find customers with different billing and shipping addresses?
Is there an Amazon login for customers?
Further Guides
We'll help you set it up
We’ll work with you to configure required fields, customer groups, and address validation, and help you figure out why a customer can’t log in.
Contact Support Now