--- title: "Implementation" url: https://docs.catalyst.zoho.com/en/zia-services/help/face-analytics/implementation/ description: "Face Analytics is a Zia AI-driven pre-built microservice that performs facial detection and predicts various facial attributes." last_updated: 2026-08-17T12:16:04Z service: Zia Services type: general --- # Implementation This section only covers working with Face Analytics in the Catalyst console. Refer to the [SDK](https://docs.catalyst.zoho.com/en/sdk/java/v1/zia-services/face-analytics/)and [API](https://docs.catalyst.zoho.com/en/api/code-reference/zia-services/face-analytics/#FaceAnalytics/) documentation sections for implementing Face Analytics in your application's code. As mentioned earlier, you can access the code templates that will enable you to integrate Face Analytics in your Catalyst application from the console, and also test the feature by uploading images with faces and obtaining the results. ### Access Face Analytics To access Face Analytics in your Catalyst console: 1. Navigate to **Zia Services** in the left pane of the Catalyst console and click **Face Analytics.** ![face-analytics](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/face-analytics-updated.webp) 2. Click **Try a Demo** and this will open the Face Analytics feature. ![catalyst_facean_test_page](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_test_page.webp) ### Test Face Analytics in the Catalyst Console You can test Face Analytics by either selecting a sample image from Catalyst or by uploading your own image. To scan a sample image with a face and view the result: 1. Click **Select a Sample Image** in the box. ![catalyst_facean_sample](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample.webp) 2. Select an image from the samples provided. ![catalyst_facean_select_sample](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_select_sample.webp) Face Analytics will scan the image for faces, analyze and predict the [attributes](https://docs.catalyst.zoho.com/en/zia-services/help/face-analytics/key-concepts), and provide a textual result of the analysis and the confidence level of each prediction in percentage values, for each detected face. ![catalyst_facean_sample_scanned](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample_scanned.webp) The colors in the response bars indicate the range of the confidence percentage of a prediction such as, red: 0-30%, orange: 30-80%, green: 80-100%. The general coordinates and the coordinates of the localized landmarks of each face are provided, in addition to the other detections, in the JSON response in the advanced landmark localization mode by default. Click **View Response** to view the [JSON response](https://docs.catalyst.zoho.com/en/zia-services/help/face-analytics/key-concepts/#response-format). ![catalyst_facean_sample_json](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample_json.webp) You can refer to the [API documentation](https://docs.catalyst.zoho.com/en/api/code-reference/zia-services/face-analytics/#FaceAnalytics/) to view a complete sample JSON response structure. To upload your own image and test Face Analytics: 1. Click **Upload** under the _Result_ section. ![catalyst_facean_upload](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_upload.webp) If you're opening Face Analytics after you have closed it, click **Browse Files** in this box. ![catalyst_facean_browse](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_browse.webp) 2. Upload a file from your local system. > **Note:** The file must be in ._jpg_/._jpeg_ or ._png_ format. The file size must not exceed 10 MB. The console will scan the image for faces and display the analysis of the four attributes of the faces detected. ![catalyst_facean_image_scanned](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_image_scanned.webp) As mentioned earlier, Face Analytics can detect and analyze the attributes of up to 10 faces in an image. You can check the results of each detected face by clicking the side arrows. The JSON response also contains the results of each detected face. ![catalyst/catalyst_facean_image_json](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_image_json.webp) ### Access Code Templates for Face Analytics You can implement Face Analytics in your Catalyst application using the code templates provided by Catalyst for [Java](https://docs.catalyst.zoho.com/en/sdk/java/v1/zia-services/face-analytics/), [Node.js](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/zia-services/face-analytics/) and [Python](https://docs.catalyst.zoho.com/en/sdk/python/v1/zia-services/face-analytics/) platforms. You can access them from the section below the test window. Click either the **Java SDK**, **NodeJS SDK** or **Python SDK** tab, and copy the code using the copy icon. You can paste this code in your web or Android application's code wherever you require. ![catalyst_facean_java](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_java_updated.webp) You can process the input file as a new `File` in Java. The `ZCFaceAnalyticsOptions` module provides you with the option to enable or disable the analysis of each attribute. For example, if you set `setAgeNeeded` as `false`, Face Analytics will not provide the age prediction results for the faces detected in the image. You can also set the [landmark localization](https://docs.catalyst.zoho.com/en/zia-services/help/face-analytics/key-concepts/#facial-landmark-localization) mode as `BASIC`, `MODERATE`, or `ADVANCED` using `setAnalyseMode`. ![catalyst_facean_node](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_node_updated.webp) In Node.js, the `facePromise` object is used to hold the input image file and the options set for it. You can specify the `mode` as `basic`, `moderate`, or `advanced`, and set an attribute as `true` or `false` to enable or disable the analysis for it. ![catalyst_facean_python](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_python.webp) In Python, the `analyse_face()` method accepts the input image as its argument. You can also specify the analysis mode as `basic`, `moderate`, or `advanced`. You can also specify the attributes `age`, `smile`, or `gender` as `true` to detect or `false` to not detect. These values are optional. All attributes are detected and the `advanced` mode is processed by default.