Reference & help

Settings reference

Complete TubePress settings reference: every tab and option in the admin panel — site, SEO, media, security, email and integrations — explained in detail.

This page is a map of the entire admin Settings area (/admin/settings), tab by tab. Each entry names the real option and, where useful, its default. For step-by-step guidance, follow the link at the end of each section to the dedicated page.

Settings are stored in the database. Every option here lives in the settings table, so it survives updates. If you ever lock yourself out (for example with a custom admin URL), you can read or change the value directly in the database.

General

site_name

Your site's name, used in titles and branding.

site_description

Default meta description and tagline.

timezone

Timezone used for dates and scheduling.

seo_noindex_entire_site

Keep the whole site out of search engines — use it while building, then turn off. See SEO.

registration_enabled

Allow visitors to create member accounts. See Users & roles.

auto_update_enabled

Apply core updates automatically. Default off. See Updating.

channels_as_users

Treat channels as user-style profiles. See Taxonomy.

comments_enabled / comments_moderation

Turn comments on, and hold them for approval. See Comments.

The General tab also holds the full comment anti-spam suite — honeypot, time-gate (spam_timegate_seconds, default 3), per-hour/day rate limits (defaults 5 / 30), duplicate window (default 60 min), link limit and length limits (2–5000). Every control is documented on the Comments page.

Appearance

Branding, colours, dark mode, layout, and the granular video-card and watch-page controls. These have their own screen rather than text fields — see Appearance for every option, and the Theme API for the variable names themes read.

Storage

Where media is stored and served: local storage plus external storage servers (S3-compatible, FTP, WebDAV) and the secure media proxy. Configured as storage backends rather than flat settings — see Storage.

Transcoding

transcode_enabled

Master switch for the transcoding pipeline.

Formats

Each rendition has a name, resolution, file postfix and FFmpeg options (plus an optional transcode_trim_start).

Servers

Local or remote FFmpeg workers — transcode_ffmpeg_path, max concurrent jobs, and transcode_max_per_tick dispatch rate.

Queue, watermark, intros, timeline

Job retries, playback watermark, pre-roll intros and scrub-preview thumbnails.

Full detail on the Transcoding and Player pages.

Security

Two-factor authentication

TOTP enrolment for admin accounts.

captcha_provider

CAPTCHA provider, with captcha_site_key, captcha_secret_key, captcha_theme and recaptcha_version.

admin_login_slug

Move the admin login off /admin to a secret path. Note it down before saving.

See Security for setup and recovery.

Advanced — Email

mail_method

How mail is sent: SMTP or an API provider.

Providers

Built-in support for Resend, Brevo, Mailgun, Postmark and SendGrid (each with its own API key/domain fields), or plain SMTP (host, port, encryption, credentials).

From name / From email / contact_email

Sender identity and where contact-form mail is delivered.

See Email & notifications, which also covers a test-send button.

Advanced — Mail templates

Edit the subject and body of each transactional email (welcome, verification, password reset and so on) and preview them before saving. Covered in Email & notifications.

Advanced — Telegram

telegram_enabled

Turn Telegram alerts on.

telegram_bot_token / telegram_chat_id

Your bot token and the chat to notify. A test button confirms delivery.

Maintenance

A health check that audits PHP, extensions, the database and writable paths; a purge tool that permanently bulk-deletes whole content types (videos, comments, non-admin users and more) in safe chunks behind a typed confirmation; and notes on the pseudo-cron and PHP version guard. See Maintenance.

Other admin areas

Some configuration lives outside Settings, in its own admin section: Ads, Import and Feeds, the Catalogue, Themes, Plugins, Languages, Reports & inbox, and Updates.

Next steps

First stepsThe settings to set on day one. SecurityLock the admin down. TroubleshootingWhen something looks wrong.

Still stuck?

Open a ticket from your dashboard and our team will help you out.

Try the live demo → Download TubePress →