{"record":{"id":"2a628cce0abd1f24","repo":"chroma-core/chroma","slug":"cannot-embed-string-query-for-key-key-key-no","errorCode":null,"errorMessage":"Cannot embed string query for key '${key}': key not found in schema. Provide an embedded vector or configure an embedding function.","messagePattern":"Cannot embed string query for key '(.+?)': key not found in schema\\. Provide an embedded vector or configure an embedding function\\.","errorType":"validation","errorClass":"ChromaValueError","httpStatus":null,"severity":"error","filePath":"clients/new-js/packages/chromadb/src/collection.ts","lineNumber":660,"sourceCode":"      const embeddings = await this.embed([queryValue], true);\n      if (!embeddings || embeddings.length !== 1) {\n        throw new ChromaValueError(\n          \"Embedding function returned unexpected number of embeddings.\",\n        );\n      }\n      return { ...knn, query: embeddings[0] };\n    }\n\n    const schema = this._schema;\n    if (!schema) {\n      throw new ChromaValueError(\n        `Cannot embed string query for key '${key}': schema is not available. Provide an embedded vector or configure an embedding function.`,\n      );\n    }\n\n    const valueTypes = schema.keys[key];\n    if (!valueTypes) {\n      throw new ChromaValueError(\n        `Cannot embed string query for key '${key}': key not found in schema. Provide an embedded vector or configure an embedding function.`,\n      );\n    }\n\n    const sparseIndex = valueTypes.sparseVector?.sparseVectorIndex;\n    if (sparseIndex?.enabled && sparseIndex.config.embeddingFunction) {\n      const sparseEmbeddingFunction = sparseIndex.config.embeddingFunction;\n      const sparseEmbeddings = await this.sparseEmbed(\n        sparseEmbeddingFunction,\n        [queryValue],\n        true,\n      );\n      if (!sparseEmbeddings || sparseEmbeddings.length !== 1) {\n        throw new ChromaValueError(\n          \"Sparse embedding function returned unexpected number of embeddings.\",\n        );\n      }\n      return { ...knn, query: sparseEmbeddings[0] };","sourceCodeStart":642,"sourceCodeEnd":678,"githubUrl":"https://github.com/chroma-core/chroma/blob/aecdd12c8a891610db8653630b066b32ceb678b5/clients/new-js/packages/chromadb/src/collection.ts#L642-L678","documentation":"Error \"Cannot embed string query for key '${key}': key not found in schema. Provide an embedded vector or configure an embedding function.\" thrown in chroma-core/chroma.","triggerScenarios":"Thrown at clients/new-js/packages/chromadb/src/collection.ts:660 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"aecdd12c8a891610db8653630b066b32ceb678b5","analyzedAt":"2026-08-16T21:53:27.228Z","schemaVersion":2},"datasetVersion":"2026-08-16T23:17:17.608Z"}