MK SYSTEM / DOCUMENTATION
YT Sheet Sources
YT Sheet sources describe where a video dataset comes from and how to build it for use in a grid.
Location: WordPress admin → YT Sheet → All Sources or Add New Source. A Source describes where videos come from. Most types produce a saved dataset by running Build now, which a Profile can then display.
Choose a source type
| Type | Input | When to use it |
|---|---|---|
| Meta Field | A selected post or page and a custom field key containing a CSV/JSON URL | The feed address belongs to a particular WordPress item and may change with that item. |
| WP Source | Published WordPress posts, field mapping and optional taxonomy filters | Videos are already represented by posts, such as Movies, and a meta field stores each video URL. |
| Feed Source | A public CSV/JSON URL or an uploaded CSV/JSON file URL | A spreadsheet or external feed supplies rows. See the Feed Source guide. |
| YouTube Playlist | Public playlist URL or ID | Collect videos from a playlist. Requires a configured YouTube API key. |
| Vimeo Channel | Public channel URL or slug | Collect videos from a channel. Requires a configured Vimeo access token. |
| Vimeo Showcase | Public showcase URL or ID | Collect videos from a showcase (album). Requires a configured Vimeo access token. |
| YouTube Channel | Channel URL, @handle or channel ID | Collect a channel’s uploads. Requires a configured YouTube API key. |
Enter provider credentials at YT Sheet → Settings → Advanced Settings. This page lists the types and shared workflow; each type has additional controls in its own panel.
Save, build and update
- Open Add New Source, add a descriptive title and select Source type. Fill in the fields shown for that type.
- Select Publish. Build is disabled while the Source is a draft. The first build uses saved values.
- Select Build now and inspect the resulting item count, built time, size and any error. Fresh means a dataset cache exists; it does not validate external video playback.
- After changing an input, select Update before Rebuild. The build action reads saved settings, not unsaved form edits.
- Use Clear cache only when you want to remove the built dataset and build again. A WP Source can also show Outdated after mapped content or settings change.
For WP Source, Auto rebuild can be Manual, Hourly, Twice daily or Daily. Automatic schedules rebuild dirty datasets through WordPress cron; the timing depends on the site’s cron execution. Some source types show their own cache controls and status. A Video Overrides tab can appear after a cache is built.
After building a Source, check the final grid against your own source data and playback URLs. Provider Sources also require valid credentials and public content.