# Tuberail documentation | WebKoding

How to install, licence and update Tuberail. Turn a YouTube channel into a gallery — or into real WordPress posts.

Source: https://webkodingtheme.com/docs/tuberail/

---

# Tuberail documentation

Turn a YouTube channel into a gallery — or into real WordPress posts.
Back to Tuberail Open the demo

## Before you start

- •WordPress 6.0 or newer, PHP 7.4 or newer
- •A YouTube Data API v3 key of your own, from the Google Cloud console
- •The channel ID, @handle or playlist you want to show
- •WP-Cron running, if you want videos imported into a post type on a schedule
Runs on your own WordPress with your own YouTube Data API key — free from Google, and quota-limited by them rather than by us.

## What it does not do

- —It does not host or upload video. Playback is YouTube&#x27;s; this is how the videos reach your site.
- —It does not come with an API key, and the quota is Google&#x27;s rather than ours. An unrestricted key that leaks is your bill.
- —It cannot show private or unlisted videos the API will not return.
- —Imported posts are copies of metadata, not of the video. Delete a video on YouTube and the post remains until the next import.

## What is in the download

A WordPress plugin ZIP with the galleries, the importer, the structured data output and a WP-CLI import command. It calls the YouTube API from your server using your key.
GPL source, no external service of ours involved.

## Installing it and getting a key

Plugins → Add New → Upload Plugin, activate, and paste the licence key from your purchase email.
Then create a project in the Google Cloud console, enable YouTube Data API v3, and create an API key. Restrict the key to that API before you paste it in — an unrestricted key that leaks is somebody else’s quota bill.
If you plan to use the scheduled import, confirm WP-Cron actually runs on the site, or point a system cron at wp-cron.php.

## Galleries and imports

Start with a gallery. It is instant, it costs almost no quota once cached, and it answers the question of whether you wanted an import at all.
Import only if you want the videos to be pages on your site — with comments, categories and their own URLs. That is an SEO decision, not a display one, and the noindex toggle exists for when the answer turns out to be no.
Leave facade embeds on. The measurable cost of a full player on a page that nobody clicks is larger than most sites can spare.

## Licence, updates and support

- One licence covers 1 WordPress site.
- 1 year of updates, from the date of purchase.
- 1 year of email support.
- Instant download + licence key by email
- 30-day money-back guarantee
Questions this page does not answer go to support@webkoding.com . If you bought from us and cannot find your licence key, look it up here .

## Common questions

### Why do I need my own API key?

Because YouTube quota is per key, and a shared key would mean your gallery stops working when somebody else’s site has a busy day. Yours is free to obtain from the Google Cloud console.

### Will it burn through my quota?

No — that is the failure mode this was built around. A naive gallery calls the API on every page view and stops working by lunchtime; here every response is cached, so page views cost nothing.

### What does importing videos into posts actually do?

It mirrors a channel or playlist into a WordPress post type on a schedule, so each video becomes a real page with its own URL, comments, categories and your theme’s rendering — pages you own, rather than embeds you rent.

### Will embedded video wreck my Core Web Vitals?

Not with facade embeds turned on: a thumbnail is shown and the player only loads when somebody clicks. A page of ordinary YouTube iframes is one of the most expensive things a site can serve.

### Does it output structured data?

VideoObject and ItemList, with a noindex toggle for when the imported pages should not compete with your own content.
