Map Any Field to Your Own Meta Keys
A synced video is only as useful as the data your site can reach. Field mapping lets you map YouTube fields to custom post meta, so every value lands on the exact key your theme, blocks, or page builder already read.
What It Does
Field Mapping routes any YouTube field — title, description, counts, published date, and each individual thumbnail size — into a custom post meta key you name. Instead of WPBuoy Video Sync deciding where data goes, you map YouTube data to post meta on your terms, so synced items slot straight into an existing content model without template changes.
Missing values are skipped rather than written blank, so a field absent on one video never overwrites good data already saved on its post.
- Map any YouTube field to a custom meta key of your choice.
- Map each thumbnail size (max-res, standard, high, medium, default) to its own key.
- Skip empty values automatically so blanks never overwrite existing data.
- Feed the custom meta keys for YouTube data your blocks, theme, or page builder already expect.
How to Use It
In a sync rule, open Field Mapping and pair each YouTube field with the destination meta key it should write to. Save the rule, and every item it imports populates those keys. Change a mapping later and the next sync writes to the new keys — no re-import required.
Why It Matters
Most importers lock you into their own meta keys, forcing template rewrites to surface the data. Mapping YouTube fields to custom post meta makes WPBuoy Video Sync fit the site you already have, which is what turns a raw import into content your existing design can render on day one.
Frequently Asked Questions
Can I map individual thumbnail sizes?
Yes. Each size — max-res, standard, high, medium, and default — can be mapped to its own custom meta key.
What happens when a field is empty?
It is skipped. An absent value never overwrites data already saved on the post.
Do existing posts update if I change a mapping?
The next sync writes to the new keys. Use an update action to refresh posts you have already imported.