Using the People Directory - Part 2 - People Utility and Component

This part 2 guide walks you through processing your people-directory.csv file and publishing a directory on your site. This includes setting up your images, creating the required utility files, uploading your dataset, rebuilding the directory XML, and inserting the component on the page where you want the directory to appear.

Before you start

You should complete Part 1 and have a CSV export ready. For the smoothest setup, keep the default filename people-directory.csv. If you’re using a different dataset name or filename, you’ll handle that during the utility configuration and component setup steps.

Publish your images

Your directory images (firstname-lastname.jpg) must be uploaded to the correct folder (_images > people) and published to display on the live site. Uploading without publishing is the most common reason images don’t appear after your page is published.

What the utility creates

When you run the People Directory Utility in _includes, the system generates the required files used to process your CSV into the XML dataset the component reads. Those generated files also need to be published.

Make sure to “View Published Page”

As laid out in the walkthroughs below, the rebuild step must run from the published version of the utility page. If you run it from an unpublished/preview context, you will trigger an error and the correct file will not be generated.

Let’s dive into how to use the people utility and component!

Walkthrough

Making updates

Once the People Utility is set up on your site, updating your directory is straightforward. Update your people-directory.csv spreadsheet and export the new version, upload the updated CSV to your _includes directory, then rebuild the dataset by compiling the XML from the published people-directory-utility.pcf page. This will regenerate the directory with your latest changes.