Page Directory
A searchable, filterable directory that lists blog posts or manually curated pages with tag-group filtering.
Page Directory
A searchable directory module that operates in two modes: BLOG mode auto-fetches published blog posts, while PAGE mode displays manually curated page entries. Both modes support a search input and tag-group filter buttons. Content editors configure the section heading, search UI labels, and card styling through the CMS.
Adding in Strapi
- Go to Content Manager > Pages > select your page
- In the Design dynamic zone, click "Add component"
- Select "Dynamic" > "Page Directory"
- Choose a mode (BLOG or PAGE), configure the search labels, and optionally add tag groups
- If using PAGE mode, add page entries manually in the repeatable component
- Save and publish
Fields Reference
| Field | Type | Required | Description |
|---|---|---|---|
| mode | Enum | Yes | Directory mode: BLOG (auto-fetches blog posts) or PAGE (uses manual page entries). Defaults to BLOG. |
| title | Component | No | Section heading displayed above the directory. |
| searchLabel | String | Yes | Label text for the search input. Defaults to "Search". |
| searchPlaceholder | String | Yes | Placeholder text inside the search input. Defaults to "Search...". |
| showTagGroups | Relation | No | Tag groups to display as filter buttons above the directory listing. |
| cardBackground | Component | No | Background styling for individual directory cards (colour, gradient, or image). |
| background | Component | No | Background styling for the entire section. |
| pageEntries | Component (repeatable) | No | Manual page entries for PAGE mode -- see sub-fields below. |
Page Entries Sub-fields
| Field | Type | Required | Description |
|---|---|---|---|
| page | Relation | No | Reference to an existing CMS page. |
| overrideTitle | String | No | Custom title that replaces the linked page's default title in the directory card. |
| overrideDescription | Text | No | Custom description that replaces the linked page's default description in the directory card. |
Variants
Default
The directory in PAGE mode with manually curated entries displayed as a searchable grid. Tag-group filters appear as buttons above the listing when configured.
BlogMode
The directory in BLOG mode, automatically fetching and displaying published blog posts. No manual page entries are needed -- the module queries the blog collection directly.
EmptyStatePage
Displays an empty state when PAGE mode has no page entries configured, or when no results match the current search query.
NullableFields
Shows the directory with minimal configuration, demonstrating default values and fallback behaviour when optional fields are omitted.
Tips
- Use
BLOGmode for a blog index page that updates automatically as new posts are published. - Use
PAGEmode when you need a curated directory of specific pages (e.g. a services overview or resource library). - In PAGE mode, use
overrideTitleandoverrideDescriptionto tailor how each linked page appears in the directory without changing the page itself. - Add tag groups to let visitors filter the directory by category -- this works in both BLOG and PAGE modes.
- The
searchLabelandsearchPlaceholderfields support bilingual content, so configure them for both English and Thai locales.