Contentful logo

Contentful Community

Queries on `JSON object` fields

I have a field of type JSON object called technical_details. It stores stuff that are not requires by all entities, but still common among many. Here’s an example:

	"weight": {
		"units": "kg",
		"value": 16300
	"width": {
		"units": "m",
		"value": 2.5
	"heigth": {
		"units": "m",
		"value": 3.24
	"length": {
		"units": "m",
		"value": 5.78
	"workingheigth": {
		"units": "m",
		"value": 26.5
... more technical details ...

I want to query on these fields. Get all items where width is greater that X and length smaller than Y.

Something like this:[gte]=10

This works, as the artNr field is an Integer field. But I cannot seem to the this same logic to work on a JSON object field:[gte]=10

Any version of these range operators I’ve testes on a JSON object field gives an error like this:

    "sys": {
        "type": "Error",
        "id": "InvalidQuery"
    "message": "The query you sent was invalid. Probably a filter or ordering specification is not applicable to the type of a field.",
    "details": {
        "errors": [
                "name": "unknown",
                "path": [
                "details": "The path \"fields.technicalDetails.nb-NO.Bredde.value\" is not recognized"
    "requestId": "ff5...b9"

Are these range queries not applicable to JSON object fields?


Hey @eirik.stavelin,

At the moment, it is not possible to extend your queries or use search parameters within your JSON object fields.

Still, I completely how that’d be helpful for your use case, and I’m promptly creating a feature request for this :slightly_smiling_face:



(Glad to hear someone say it not possible, because it seems like a thing that should work, and it was not clear why it didn’t).

We don’t make that very explicit in the documentation, but we do mention that our search parameters work with any of our collection endpoints, which includes entries, content types, assets, but not directly JSON object fields themselves.

Anyway, I’m glad this helped clearing things out and let me know if you have any other questions :smile:

@gabriel Any news on that feature request? That would be really helpful to do queries on any content stored in the JSON field. :slight_smile:

1 Like

@gabriel same for me, i would be absolutely glad is this feature was released.

Hi everyone, something new on this topic ?
It will offer a really cool flexibility to build cool stuff if we can filter on JSON objects fields.

Can we hope something new soon ?

1 Like

Yes, this would be helpful, as we have some ties between certain entries stored within a hidden json object.

(our usecase is: ) As the delete webhook only returns id and content type, we need to search for the id within the json data to find the entry where we should remove that id, currently it’s impossible.

Yes, agreed we are sitting with the same issue. is this something being worked on?