How to Set Job List Media and Candidate List Media in Refari

This article explains how to set and manage list media (job list media and candidate list media) in the Refari platform. You’ll learn how to select media per-advert, how hashtag-driven company rules work, how to avoid making Refari the advert owner (preserving ATS sync), and how to apply company/brand-specific labels.

How to set Job List Media (Step-by-step)

Follow these steps to choose the media that appears on your job board as the job list thumbnail.

1. Open the job advert from the Job Ads tab and click "Edit job advert".
2. Locate the "Set job list media" control within the edit modal. 
3. Choose either a media asset embedded in the advert or an asset from the company media library (the library includes items available via hashtag rules).
4. If the item is a video, avoid clicking the video thumbnail itself (it may play or navigate). Use the small grey banner or the selection control to pick the item.
5. Click Save to apply the change, then refresh the job board to verify the thumbnail updated.

    Notes: Video thumbnails may display differently depending on the job board or talent board widget variant. Always preview the board variant you plan to publish.
  

Sync-friendly option (do not change advert ownership)

If the advert originated from an ATS or CRM and you want to avoid making Refari the owner (which would stop future ATS updates from syncing), use the sync-friendly "Set job list media" button from the Job Advert drawer

• The sync-friendly option shows only the media currently embedded in the advert (not the full company library).
• Select one of those in-advert assets as the list media and avoid clicking Save on the entire advert if you want to preserve ATS ownership and syncing.

    Notes: If you edit and then Save a job advert in Refari after it’s been imported from an ATS, Refari becomes the advert’s owner and the advert will no longer reflect changes made in the original ATS.
  

Candidate / Talent Board (Candidate List Media)

Candidate adverts use the same selection patterns. Each candidate’s media is generally unique to that candidate (there is no global candidate media library). To set candidate list media:

1. Open the candidate advert drawer and use the "Set Candidate List Media" button to pick from the candidate’s attached media.

2. Or edit the candidate advert and click on the 'Set Candidate List Media' at this stage. (the same rules about video selection and saving apply).

    Other articles you might be interested in: Tags in your job adverts, how and why?


Optimum resolution for job media images and gifs


How to create JobMedia using tags and bind them to display images and videos
  

Customisable Labels Feature (Brand / Company Labels)

To append custom labels for brands or campaigns and have them control list media:

1. In Company Settings, create hashtag or label definitions (for example: #scaleup, #brandX).
2. Create media rules that map a hashtag/label to a specific media asset (assign a hero image or video to that label).
3. Add the label to the job or candidate advert (in the advert description).
4. The platform will use the configured asset when the label appears in the advert, unless manually overridden at the advert level.

    Ideas: Keep a curated set of brand-approved assets per label to ensure consistent look and feel across boards. Use consistent file naming (e.g., brandX-hero.jpg) to make mapping easier.
  

Troubleshooting Checklist

• Thumbnail didn’t update? Refresh the job board and ensure you saved the advert.
• Video plays when you try to select it? Use the small grey selection banner to pick the item instead of clicking the thumbnail.
• ATS updates no longer appear in Refari? Check whether the advert was edited and saved in Refari; if so, Refari is likely the new owner.

Final Notes

After making any changes, always preview the relevant job or talent board widget to confirm how thumbnails and videos appear. Use hashtag-driven media rules to standardise presentation across brands