---
title: "Custom Administrative Facets"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Custom Administrative Facets

This page is written for C++, C#, Java, Python, and Swift.

Parts of this page are for some programming languages only, and name them. For one language's text alone, see [C++](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets/java.md), [Python](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets/python.md), and [Swift](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/custom-administrative-facets/swift.md).

Applications can add custom facets to the [admin object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object.md) by calling `addAdminFacet` on the Communicator ([C++](https://code.zeroc.com/ice/3.8/api/cpp/classIce_1_1Communicator.html), [C#](https://code.zeroc.com/ice/3.8/api/csharp/api/Ice.Communicator.html), [Java](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/Communicator.html), [Python](https://code.zeroc.com/ice/3.8/api/python/Ice.Communicator.html), and [Swift](https://code.zeroc.com/ice/3.8/api/swift/documentation/ice/communicator)) with a servant and facet name, before or after the admin object is created, and remove them with `removeAdminFacet`.

A custom facet's servant implements a Slice interface of your choice. Administrative clients invoke it through a proxy to the corresponding facet of the admin object, as described in [Using the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/using-the-admin-object.md).

The [facet filter](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets.md) also applies to custom facets. When `Ice.Admin.Facets` is set, the communicator exposes only the facets that the filter lists. Excluded facets remain registered: `findAdminFacet` and `findAllAdminFacets` still return their servants, and `removeAdminFacet` removes them.

For an example, see the [Process](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/process-facet.md) facet.

## See Also

- [Filtering Administrative Facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets.md)
- [The Process Facet](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/process-facet.md)
