> For the complete documentation index, see [llms.txt](https://docs.acpt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acpt.io/integrations/facetwp.md).

# FacetWP

How to use ACPT fields as FacetWP facet data sources

ACPT integrates with [FacetWP](https://facetwp.com/) so that any ACPT field can be used as a facet **Data Source**, ordered by choice, indexed, and rendered by FacetWP's Listing Builder.

### First steps

Install and activate [FacetWP](https://facetwp.com/), then go to **FacetWP → Facets → Add new**.

### Using ACPT fields as a Data Source

Open the **Data source** dropdown when creating or editing a facet. Every ACPT field available for the current context is listed under a dedicated **ACPT** group, prefixed with `acpt/`.

Each choice is labeled as:

```
[Field group label] Field label
```

Fields nested inside a **Repeater** are listed individually, with the parent chain included in the label:

```
[Field group label] Parent field → Child field
```

### Supported field types

* **Select**
* **Select multiple**
* **Checkbox**
* **Radio**
* **Toggle**
* **Date**
* **Date Range**
* **User**
* **User multiple**
* **Post** (relational, generic)
* **Post Object**
* **Post Object multiple**
* **Term Object**
* **Term Object multiple**
* **Repeater** (any supported field type nested inside)
* Any other textual field type (Text, Textarea, Number, etc.) is indexed as-is

For relational field types (Post Object, Term Object, User, and the generic Post relation), FacetWP indexes and displays the related item's title/name/display name rather than its raw ID.

### Re-indexing

After creating a facet on an ACPT field, or after changing field values on your content, run **FacetWP → Settings → Re-index** so the new choices and values are picked up.

### Sorting facet choices

Set a **Select**, **Radio**, or **Checkbox** facet's **Sort by** option to **Term order** to have FacetWP follow the order in which the field's options are configured, instead of alphabetical or count-based sorting.

### Layout Builder

When an ACPT field is used inside a FacetWP Listing Builder template, relational and choice fields are rendered as readable output — a linked post/term title, a user's display name, or the option's label — instead of the raw stored value.

### "Other" data source

For advanced templates that need to pull a value FacetWP doesn't natively expose as a facet, an ACPT field can also be referenced through FacetWP's `source_other` mechanism, using the same `acpt/` prefix.