Must not contain whitespace – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 6.8-8.9

Before you dig into reading this guide, have you tried asking OpsGPT what this log means? You’ll receive a customized analysis of your log.

Try OpsGPT now for step-by-step guidance and tailored insights into your Elasticsearch operation.

Briefly, this error occurs when Elasticsearch encounters a field or query string that contains whitespace, which is not allowed in certain contexts. This could be due to incorrect formatting in the request body or in the index mapping. To resolve this issue, you can either remove the whitespace from the offending field or enclose the field in quotation marks if it’s a query string. Additionally, ensure that your index mapping is correctly formatted and does not contain any unnecessary whitespace.

For a complete solution to your to your search operation, try for free AutoOps for Elasticsearch & OpenSearch . With AutoOps and Opster’s proactive support, you don’t have to worry about your search operation – we take charge of it. Get improved performance & stability with less hardware.

This guide will help you check for common problems that cause the log ” must not contain whitespace ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: .

Log Context

Log “must not contain whitespace” class name is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 private static void validate(final String repositoryName; final String snapshotName) {
 if (Strings.hasLength(snapshotName) == false) {
 throw new InvalidSnapshotNameException(repositoryName; snapshotName; "cannot be empty");
 if (snapshotName.contains(" ")) {
 throw new InvalidSnapshotNameException(repositoryName; snapshotName; "must not contain whitespace");
 if (snapshotName.contains(";")) {
 throw new InvalidSnapshotNameException(repositoryName; snapshotName; "must not contain ';'");
 if (snapshotName.contains("#")) {


How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?