Accredited Employers Directory
The Accredited Employers directory is a custom API-backed module. It reads employer records from NationBuilder people data rather than from nested website pages.
#Page wiring
The landing page is page 4056. Its child module, accredited_employers_grid, must have both tags:
module_accredited_employers_gridsearch_tag:LW-employer
The first tag selects the directory module. The second tells the API to return people tagged LW-employer. If search_tag:... is missing, the page shows a configuration error instead of a directory.
The module page headline and Basic content can provide an optional heading and introduction above the filters.
Employer data mapping
| Directory output | NationBuilder person/profile data |
|---|---|
| Included in results | Person has the LW-employer tag |
| Display name | first_name followed by last_name |
| Logo | Secure profile image URL |
| Website link | employer_website custom field |
| Location filter | region field |
| Industry filter | employer_industry custom field |
Employers are sorted A–Z by their displayed name after all API pages have loaded. Location and industry options are generated from the returned records. Choosing both filters uses AND logic: a record must match the chosen location and industry.
If an employer has a website, its logo/name card is clickable. Without a website the card remains static. A missing logo leaves the logo area empty but does not remove the employer.
Add or update an employer
- Find or create the employer's organisation/person record in NationBuilder.
- Apply the tag
LW-employeronly when the record should be public in this directory. - Put the public organisation name across the name fields in the same pattern used by existing employer records.
- Upload its logo as the profile image.
- Complete
employer_website,regionandemployer_industryconsistently. - Save the record and allow time for the API and site cache to update.
- Check the A–Z placement, link, location filter and industry filter on the live directory.
Technical flow
NationBuilder people tagged LW-employer
↓
Living Wage match-by-tag API (paginated)
↓
Theme directory script
↓
A–Z employer cards + generated filters
The API endpoint, access token and rendering script are developer-managed theme configuration. Do not place those values in page content or change search_tag:LW-employer without a coordinated data migration. If the loading spinner never finishes or an API error appears, contact For Purpose.