returns True if an instance of the specified category is detected in image.


returns True if at least one instance of each of the categoryi is detected in image.


returns True if image contains an instance of at least one of categoryi.

Details and Options

  • ImageContainsQ tries to find subimages of image that may be an instance of a given category.
  • Possible forms for category include:
  • "concept"named concept, as used in "Concept" entities
    "word"English word, as used in WordData
    wordspecword sense specification, as used in WordData
    Entity[]any appropriate entity
    category1|category2|any of the categoryi
  • The following options can be given:
  • AcceptanceThreshold Automaticidentification acceptance threshold
    MaxOverlapFractionAutomaticmaximum bounding box overlap
    TargetDevice "CPU"the target device on which to compute
  • ImageContainsQ uses machine learning. Its methods, training sets and biases included therein may change and yield varied results in different versions of the Wolfram Language.
  • ImageContainsQ may download resources that will be stored in your local object store at $LocalBase, and can be listed using LocalObjects[] and removed using ResourceRemove.


open allclose all

Basic Examples  (2)

Check whether an image contains a specific category of objects:

This image contains at least a bird:

The image does not contain dogs:

Test for the simultaneous presence of multiple categories:

Scope  (3)

Test of whether an image contains an instance of a particular object:

Test of whether an image contains an instance of all the specified objects:

Test of whether an image contains an instance of any of the specified objects:

Options  (2)

AcceptanceThreshold  (1)

Using the default AcceptanceThreshold, an object may not be identified:

Specify a lower threshold to accept a less certain match:

TargetDevice  (1)

By default, the function is evaluated on CPU:

Use the TargetDevice option to specify a different device:

Wolfram Research (2019), ImageContainsQ, Wolfram Language function,


Wolfram Research (2019), ImageContainsQ, Wolfram Language function,


Wolfram Language. 2019. "ImageContainsQ." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2019). ImageContainsQ. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_imagecontainsq, author="Wolfram Research", title="{ImageContainsQ}", year="2019", howpublished="\url{}", note=[Accessed: 23-April-2024 ]}


@online{reference.wolfram_2024_imagecontainsq, organization={Wolfram Research}, title={ImageContainsQ}, year={2019}, url={}, note=[Accessed: 23-April-2024 ]}