05-gotchas.md

Common Gotchas & Caveats

Things to watch out for when managing the Staff Directory via the CRM.

The Group field on the content channel item must match an entry from the Staff Page Departments defined type.
Any mismatch or missing value results in the staff member being excluded from filtered or grouped staff views.

URL: Staff Page Departments

Duplicate Priority values in the same featured group (e.g. “Pastor” section) can cause unpredictable ordering.
Always assign unique, sequential priority numbers within groups where ordering matters.

Staff members with ShowOnPage set to No remain in the CRM but won’t render on the public staff page.
Easy to overlook during updates — always verify this toggle if someone isn’t showing up.

Staff members with a selected Group aka Staff Page Directory selected will shovel in on that selection.
If unselected, the staff memeber will not have a bucket to get put into and in turn will not show on the page. You might toggle show on page, but if you don't also have the department selected, still won't show.

Image uploads must be consistent in size and aspect ratio to maintain visual alignment on the public staff page which is 200x200px.
No enforced dimension constraints in the CRM, so discrepancies need to be managed by the uploader or it will go crazy and break the page.

Deactivating or archiving a content item removes it from the public page.
Simply clearing Group or toggling ShowOnPage hides it from the page but leaves it active in the CRM for future reuse.

Any additions or edits to the Staff Page Departments defined type immediately affect available options in the Group field.
Changes here require caution — renaming or removing a department can orphan existing staff records and that department's bucket and all staff in that department will no longer render to the page. If you delete a department in the defined type, you need to go back to all the staff from that department and re add them to get them back to the page.