Step 6: Link Your ECLs to Locations

After your ECLs are created in Yext, you’ll need to link them to your location entities in Yext. There are three ways to do this:

  • Using a file upload connector (to link ECLs to entities in bulk)
  • From the ECL (individually)
  • From the entity (individually)

To do this, you’ll need to export your ECL information, export your entity information, and then re-upload a spreadsheet containing your ECL and entity IDs.

Export ECL IDs

  1. Navigate to Content > Products and Services to view ECLs you’ve created.
  2. Select the checkbox next to the relevant ECLs (or choose Select All at the top of the page).
  3. Click the Select Action pill at the bottom of the page and choose Export. This will download a spreadsheet containing theECLs and their IDs.
  4. Open the downloaded file. The only column you will need is the ProductListID column. This is what you will use to associate your location entities with the ECL.

Export Entity IDs

  1. You will also need to export the relevant location entities. The easiest way to do this will be to use the saved filter you created in Step 3 of this guide to assign your Reserve with Google licenses. Navigate to Content > Configuration and click on the Saved Filters tile to view all your saved filters.
  2. Click the saved filter you created in Step 3. You will be brought to the Entities screen and the entities in your selected saved filter will be displayed.
  3. Click the checkbox at the top of the entities list to select all the entities in your saved filter. Then, click the More Actions pill and select Export Entities.
  4. You’ll be brought to the first step of the Export Entities flow (Basic Info). Click Continue in the bottom right of the screen.
  5. In the Export Scheme step, make sure the Entity ID field is included in your export. If desired, you can remove the Yext ID field. Add any other fields that you may need to identify your location entities (Name, etc.)
  6. After adding your fields, click Continue to download your entities file. If you want to save this export configuration for later (to easily export again), you can do so now. Otherwise, click Done to exit the Export flow.

Combine and Upload ECL and Entity Data

See this video for steps on creating a file upload connector once you have exported your ECL and entity information:

  1. Combine your ECL export file and your entities export file so that you have one spreadsheet with the following columns:
    • ProductListID (from the ECL export)
    • Entity ID (from the entity export)
    • Any other identifying fields from your entity export, if desired
  2. Navigate to Content > Connectors and click Add Connector in the top-right of the screen.
  3. Select File Upload as your data source.
  4. Select Upload File and choose your file with the combined ECL and entity information. Keep the File Settings as-is.
  5. You do not need to add any selectors on the Specify Selectors screen. Click Add Default Selectors and then click Continue in the bottom right.
  6. On the Destination screen, select Content.
  7. On the Map Fields screen, select the relevant entity type from the dropdown. This should match the entity type of the entities you exported earlier.
  8. Ensure the columns in your spreadsheet are mapped to the proper entity fields. This should be automatically detected.
    • The Entity ID column should map to the Entity ID field.
    • The ProductListID column should map to the Product Lists > Ids field.
  9. Click Save in the lower right. In the modal that appears, enter a name for your connector and click Save and Run Now.
  10. Select Run in Default Mode, and then click Save and Run Connector. Your data will begin processing immediately, and you can monitor the status of the connector run on the Connector Summary screen.

If you want to link ECLs to individual entities (from the ECL or from the entity itself), follow these steps.

  1. In the navigation bar, go to Content > Products & Services.
  2. Click on your desired ECL.
  3. Locate the gray box in the upper right of the screen containing the information about the ECL. On the Entities item, click Change.
  4. In the modal that appears, select the location entity you want to link that ECL to.
  5. Click Apply and then Save.

See this video for steps:

  1. In Content, click on the location entity that you want to link an ECL to.
  2. Locate the Product Lists field on the entity. You can use the Search Field pill at the top of the entity to do this.
  3. Click into the Product Lists field and select Add.
  4. Type the name or ID of the ECL you want to add to the entity and select it from the dropdown.
  5. Click Save.

See this video for steps: