Charitable Videos - WordPress Plugin

Charitable Videos Guide: How to Add Video to a Donation Campaign

Charitable Videos is not there to decorate the page. Its purpose is to explain the reason behind the fundraiser in a clear, compelling way. In this guide, we will walk through how to use the extension in WordPress: what to check before installation, where to place the video link, when it makes more sense to upload your own file, how to review the public campaign page, and what to do if the video does not appear or gets in the way of the donation form.

This article is written for a site administrator, nonprofit content editor, or developer who already works with Charitable and wants to make a campaign more persuasive. We will not repeat the basics of fundraising in WordPress. Instead, we will go from video prep to final review on the campaign page, where a visitor sees the story, fundraising goal, donation button, and embedded video.

The key thing to understand about Charitable Videos is simple: it does not have a separate settings page. The video is added to a specific campaign, so the quality of the outcome depends less on a long list of global options and more on the video source you choose, the structure of the campaign description, the WordPress theme, caching, and how carefully you review the page before publishing.

Where Video Actually Makes a Campaign Stronger

Video works best on a donation page when a single photo and short description are not enough. That might be a message from the nonprofit founder, a field report from the project site, a brief explanation of a medical need, a volunteer story, an update from an earlier phase of the campaign, or a demonstration of the outcome the team hopes to achieve through fundraising.

Charitable Videos adds a separate Video field to the campaign. According to the official documentation, the administrator opens the campaign under Charitable > Campaigns, goes to the Video tab, pastes the video URL or uploads a file, saves the campaign, and the video is then automatically displayed near the top of the campaign page after the description. That behavior matters: the video is not a separate widget you have to place manually in each template. It becomes part of the campaign itself.

In practice, this is convenient for smaller teams. An editor does not need to know HTML iframe code, paste YouTube markup by hand, or ask a developer to add a block to the template. They work inside the familiar WordPress admin area and manage media directly within the campaign. The key check after saving is to open the public campaign page and confirm that the video appears before the donation form, loads without errors, and does not break the donation flow.

But that same simplicity creates a few pitfalls. If the video is too long, a donor may watch only the beginning and leave without taking action. If you upload a heavy file to weak hosting, the page may become slow. If you use a video with embedding restrictions, the site may show a blank space or a message from the video platform. That is why working with Charitable Videos starts before WordPress: first decide what story you are telling and where the video will be hosted.

Which Campaigns Benefit Most from Video

Video is especially useful for campaigns where you need to show trust, real-world context, or a complex problem. For example, a nonprofit may be raising money to restore a room after a fire. A photo shows the damage, but a one-minute video can explain the scale of the problem, introduce the team, and make the situation feel concrete. For an education fundraiser, a video can show the classroom, the instructor, and the purpose of the purchase. For a medical fundraiser, more caution is needed: the video should not reveal unnecessary personal data, but it can still explain the care pathway and the organization’s role.

Video can also help with steady, ongoing fundraising, though it is not always essential. If the campaign centers on a clear purpose, such as a monthly food fund, a short video showing the impact of the work is usually better than a long presentation about the organization. The video should answer the question "why should I trust this specific campaign," not replace every written explanation on the page.

When Video Can Hurt the Campaign

Charitable Videos does not automatically make a video effective. The plugin only places it in the right part of the campaign. A video can get in the way if it starts with aggressive volume, requires login on an external platform, is unavailable in some countries, contains outdated information, or makes the page too heavy. There is also the risk of emotional overpressure. Nonprofit sites need to keep a respectful tone: show the problem, explain the action, and leave the donor with a clear choice.

If the organization does not yet have a strong video, do not insert random promotional footage. It is better to publish the campaign first with solid text, images, and transparent fundraising amounts, then add the video later. Charitable lets you edit a campaign after publication, so the video can be introduced as an upgrade rather than a launch requirement.

How to Prepare the Video Before Working in Charitable

The most common mistake when adding video to a fundraising campaign is assuming that the technical Video field solves the editorial problem. Charitable Videos accepts a link or a file, but it does not decide what the video should say, what thumbnail will build trust, or what next step the donor should notice. That is why it helps to prepare a short editorial brief before you even open WordPress.

For a donation campaign, the video should not feel like a general film about the organization. It should work as a short answer to the specific fundraiser. The viewer should quickly understand who the campaign helps, why the problem is real, what will change after the donation, and how the organization will report back. If the video opens with a long intro, a list of every program the nonprofit runs, and abstract values, it will work less effectively alongside a donation form.

Planning the Video for a Campaign Page

The structure can be very simple. In the first few seconds, name the problem and show the person, place, or outcome connected to the fundraiser. Then add one short section explaining exactly what needs funding. After that comes proof: footage of the team at work, a note from the coordinator, part of a report, the room, equipment, classroom, shelter, or another visible sign that the need is real. At the end, you do not need to push the viewer with an aggressive "click the button now" message. It is enough to connect the video to the page action: making a donation, sharing the campaign, or returning to the detailed description.

This approach helps Charitable Videos do exactly what it is meant to do. The plugin places the video inside the campaign context, and the video supports the donor’s decision. If the video does not present a clear need, the visitor may become interested in the organization in general but still not understand why this particular campaign needs support.

Thumbnail, Audio, and Captions

The video thumbnail is often visible before playback, so it needs to make sense without sound or extra explanation. For a charity campaign, the most effective still usually includes clear context: the team on site, the aid itself, the project space, or the visible outcome of the work. A random paused frame with the speaker’s eyes closed or a plain logo on an empty background tends to reduce trust.

Check the audio separately. Many donors view fundraising pages in noisy environments or without headphones, so the video should still make sense with captions or at least with a clear visual narrative. Charitable Videos does not add captions on its own. If you use YouTube or Vimeo, prepare captions on the platform side. If you upload a file to WordPress, decide in advance how the user will understand the message without sound. In some cases, a short text summary right before the video works better than forcing the visitor to guess.

Privacy and Consent

For a nonprofit site, it is especially important not to publish unnecessary personal data. A video may show children, patients, addresses, documents, or the faces of volunteers and partner staff. Before uploading, make sure the organization has permission to publish the footage and that the frame does not expose medical records, phone numbers, home addresses, banking details, or any information that should not be public.

If the campaign is sensitive, use neutral footage: staff hands packing aid, a wide shot of the space, purchased supplies, or an interview with the coordinator that does not reveal the recipient’s identity. That does not make the campaign less persuasive. On the contrary, careful handling of data shows organizational maturity. A safe video is better than an emotional video that violates someone’s privacy.

File Name, Format, and Backup Version

If you upload video to WordPress, give the file a clean Latin-character name such as school-room-campaign-intro.mp4. That makes it easier to find in the media library and reduces the chance of path-related issues. Avoid names like final_final_new_2.mov. Before uploading, save both the original file and a compressed web version separately so you can quickly replace it if the published version turns out to be too heavy.

For externally hosted video, keep a backup URL in the campaign working document. That might be a shorter cut, a backup copy on another platform, or a temporary fallback with no video at all. If the platform blocks embedding, the team should not spend hours searching for the original source. This matters most for urgent campaigns where every email points visitors to a page that is already live.

What to Check Before Installing the Extension and Adding a Video

Before installing Charitable Videos, review the basic site setup. The extension works inside the Charitable ecosystem, so you first need the Charitable plugin itself, WordPress administrator access, and permission to edit the campaign you plan to update. The official Charitable installation guide lists the WordPress, PHP, and MySQL requirements for the current plugin version; it is best to confirm the exact versions in the documentation before deployment because requirements can change.

If you work with Charitable Pro, pay attention to one important detail: some features that were once treated as separate extensions are now described in newer Charitable materials as built-in Pro functionality. In this article, we are approaching the task from the perspective of Charitable Videos and its documentation, but in a real project, you should verify where the Video field is actually available on your site: in a separately installed extension or within your current Charitable Pro feature set.

Do not start by installing the extension on a live fundraiser that is already accepting donations. Pick a test campaign first or create a draft. Video affects the top of the campaign page and may change how the page behaves for donors, especially on mobile and in themes with a narrow content column.

Check User Role and Access

The person adding the video should have permission to edit campaigns and upload media. In a small nonprofit, that is often the site administrator. In a larger organization, it is better to separate responsibilities: an editor prepares the video and copy, and an administrator publishes the changes after review. If the editor does not see the Video tab, first check whether the extension is active and whether the user has the correct permissions before looking for problems in the theme or cache.

For sites that involve external contractors, it helps to keep a simple change log: who replaced the video link, when the new video version was published, and which campaign was affected. That is not a Charitable Videos feature, but it is good operational discipline. It makes rollback much easier if donors report that the wrong message appears, an outdated video opens, or the player is blank.

Check the Video Source

There are two main options: insert a link to an external video or upload a file to the site. External video is usually the better fit for YouTube and Vimeo because WordPress can handle those links through its embed system. WordPress documentation specifically notes that YouTube and Vimeo are supported embed sources, but an individual video may still have restrictions: privacy settings, embedding disabled, regional limitations, or removal by the publisher.

Uploading your own file is useful if the organization does not want to host the video on a third-party platform or if it uses internal media. The Charitable Videos documentation lists common upload formats including mp4, m4v, webm, ogv, wmv, and flv. In practice, most modern sites choose mp4 or webm because browser support is stronger and administrators are more familiar with them.

Local upload comes at a cost: file size, hosting load, and possible limits in the WordPress media library. If the video is large, a weak server may deliver it slowly, and a mobile visitor may leave before even seeing the donation form. That is why, for most public campaigns, it is safer to start with an externally hosted video on a platform that already provides a player, adaptive delivery, and quality handling.

Review the Campaign Copy Before the Video

Charitable Videos displays the video after the campaign description. That means the short description should prepare the viewer for what comes next. If the paragraph before the video lacks specificity, the video feels disconnected. A strong sequence looks like this: the description defines the problem, the fundraising goal is visible nearby, then the video provides real-world proof, and after that the donor can quickly find the donation button.

Before installing the extension, reread the campaign description. Remove outdated amounts, clarify the goal, add one strong paragraph before the video, and make sure the video does not repeat the exact same message word for word. The donor should not feel forced to read and watch the same thing twice.

Installing the Extension and Running the First Check in WordPress

Charitable Videos is installed like a standard WordPress extension. The official Charitable extension guide describes two working paths: upload the ZIP file through Plugins > Add New > Upload Plugin, or install an available extension through the Charitable add-ons screen if it is included in your plan. In either case, the plugin must be activated after installation.

In this guide, we are not covering purchasing, licensing, or activation workarounds. For an already obtained product, the practical part is what matters: the extension must be active, Charitable must recognize it as part of its system, and the campaign editor must show the option to add a video. If you do not see the expected element, do not jump straight into code changes. Start with the basics: confirm that core Charitable is active, confirm that the extension is active, confirm the user role, and make sure you are editing an actual Charitable campaign rather than a regular WordPress page.

Installing Through the Admin Dashboard

1. Log in to WordPress with an administrator account.
2. Go to Plugins > Add New and click Upload Plugin.
3. Select the extension ZIP file, install it, and click Activate Plugin.
4. Check the list of installed plugins and confirm that Charitable Videos is active.
5. Open Charitable > Campaigns and go to a test campaign.

After that, do not go looking for a separate settings page. The Charitable Videos documentation clearly states that the extension does not have its own options page. That is normal behavior, not a sign that something is wrong. Configuration happens at the campaign level.

Installing Through the Charitable Add-Ons Screen

If the extension is available in your account and plan, you can use the Charitable add-ons screen instead. This is convenient for sites where the administrator does not want to upload ZIP files manually every time. But the verification process is the same: the extension is active, the Video tab is available in the campaign, saving works without errors, and the public page displays the video.

If automatic installation fails, the cause may be hosting restrictions, file system permissions, or WordPress configuration. In that case, use manual installation through the admin dashboard and leave FTP to an experienced administrator. Do not blindly change permissions on system folders or disable hosting security features just to force one installation through.

First Check After Activation

The fastest initial check takes only a few minutes. Create or open a draft campaign, find the Video tab, paste the link to a public YouTube or Vimeo video, save the campaign, and open the public preview. If the video appears, move on to campaign-level setup. If the tab is missing, go back to the plugin list and confirm that both core Charitable and the required extension are active.

If the site uses Charitable’s newer visual campaign builder, some parts of the interface may look different from the older documentation for legacy campaigns. That is why it helps not to memorize an old layout, but to look for the functional element that matters: campaign settings and the video field. In the older documentation, the path through Charitable > Campaigns and the Video tab remains the main reference point for Charitable Videos.

Quick check: the extension does not need to appear as its own menu item. If you can add a video inside a campaign and it appears on the public page, the basic installation worked.

The Video Tab: URL, File Upload, and Display Behavior

The main working screen in Charitable Videos is the Video tab inside the campaign. There, the administrator chooses one of two approaches: paste the URL of an external video or upload a local file. An external link is usually simpler: WordPress recognizes the supported source, retrieves the embed code, and displays the player. An uploaded file uses WordPress media handling and the HTML5 player.

This choice affects performance, control, privacy, and troubleshooting. If the video is hosted on YouTube, Vimeo, or another supported platform, you get a convenient player, quality adaptation, and less load on the site. But you also depend on the video’s settings: is embedding allowed, is the video hidden, and is it available in the regions your users are in? If the file is uploaded to WordPress, you control the source, but you take on the delivery load and format compatibility yourself.

When to Use a URL

Use a URL if the video is already published on a reliable video platform and does not contain restricted information. For a public campaign, this is usually the better option. A URL is easier to replace, does not increase the size of site backups, and usually handles traffic spikes better after an email blast or social post.

Before saving, open the video in a private browser window. If it requires account login, does not open without a direct link, or blocks embedding, the campaign page may have the same problem. WordPress documentation for YouTube embeds specifically notes that not every video can be embedded: the publisher must allow embedding, and private videos are not a good fit.

External Link Checklist

• The video is public, or at least available by link if the platform supports that mode.
• Embedding on third-party sites is allowed in the video settings.
• You pasted the video URL itself, not arbitrary HTML iframe code.
• The video is not deleted, age-restricted, or locked behind account login.
• The thumbnail makes sense without sound and does not look like a random paused frame.

If the platform supports oEmbed, WordPress will usually handle the URL correctly. If the source is unusual, do not rely on guesswork. Check the list of supported WordPress embed providers or use a video platform with explicit support.

When to Upload Your Own File

Uploading a file makes sense for a short video that the organization does not want to publish on an external platform, or for a project with its own media storage infrastructure. That could be an internal report, a short clip from an event, or a message that should live only on the nonprofit’s site.

But uploaded video requires more care. A file that is too heavy will slow down the page, increase backup size, and may fail in some browsers. For a public site, use a common format, verify the file size, choose a clear opening frame, and do not upload the raw export directly from your editing software without compression.

Uploaded File Checklist

• The file opens correctly in the WordPress media library and has a clear filename without random characters.
• The format is supported by both WordPress and Charitable Videos.
• The file size does not make the page noticeably slow on mobile networks.
• The video does not contain personal data that should not be published.
• After saving the campaign, the player is visible in both a normal and a private browser window.

Do not upload multiple versions of the same video hoping the plugin will choose the best one automatically. Charitable Videos is built to attach video to a campaign, not to act as a full video hosting platform. If you need advanced quality delivery, captions, view analytics, and reliable regional distribution, use a dedicated video platform and embed the link instead.

How the Video Is Embedded on the Campaign Page

After you save the campaign, Charitable Videos displays the video near the top of the campaign after the description. It is a small detail, but it shapes the structure of the entire page. The visitor gets context first, then sees the video, and then moves on to the fundraising details and donation action. If the description is too long, the video may sit too far down the page. If the description is too short, the video may appear without enough context.

A strong campaign page follows a simple sequence: reason, proof, action. In Charitable, video often provides the proof. It should support the donation form, not compete with it. That is why, after adding the video, you should evaluate more than just whether it embedded successfully. You also need to assess how it changed the top of the campaign page.

Video Placement After the Description

The official documentation states that the video is automatically embedded after the campaign description. That works well when the description is short and functions as an introduction. But if your description runs for several screens of text, the video can get lost. In that case, it is better to shorten the intro and move the longer story lower on the page, into the extended description, campaign updates, or a separate information section.

For most campaigns, 2 to 4 short paragraphs before the video are enough: who is fundraising, what the funds are for, why the need is urgent or important, and what the viewer will see in the video. After the video, the next step should still feel obvious: the amount, the goal, the donation button, or the form. If the visitor has to hunt for how to donate after watching, the video is hurting conversion rather than helping it.

How It Works with the Visual Campaign Builder

Current Charitable documentation describes a visual campaign builder with templates, fields, goal settings, end dates, and campaign display options. In that kind of campaign, the editor is working not only with text but with a prebuilt page structure. Charitable Videos adds a media element to that structure, so it is important to review the result in the actual template being used, not just inside the editor.

If the campaign was created in legacy mode, the path and interface may look different. Charitable documentation separately notes that legacy campaigns are still supported, but they are no longer the default way to build new campaigns. That means that on an older site, the video may still be added through the familiar metabox layout, while on a newer one it may sit alongside the visual builder settings. In either case, the final check is the same: the public page should display the video, description, goal, and donation form in a clear order.

What the Donor Actually Sees

The donor does not see the Video tab, file format, or internal WordPress behavior. They see a page with a story. So review the outcome not as an administrator, but as a first-time visitor who arrived from an email or social post. Is it clear why the video is there? Is it obvious that this is a fundraising campaign? Does the player take over the entire above-the-fold area so that the goal and action are pushed too far down?

Check the page on both desktop and phone. Even if this guide does not treat smartphones as the primary visual reference, mobile review matters in real donation flows. The video player should be responsive, stay within the content column, and avoid overlapping the form. If a WordPress theme handles embedded video poorly, the problem may be in the theme CSS rather than in Charitable Videos itself.

Practical Workflow: A Campaign with a Video Message and Donation Testing

Let’s use a concrete example. A nonprofit organization is launching a campaign to renovate a learning room. It has a short video message from the coordinator, photos of the space, and a basic Charitable donation form. The goal is to add the video in a way that builds trust, does not slow down the page, and does not interfere with testing the donor journey.

Goal

Create a campaign page where the visitor first understands the need, then watches a short video confirming the problem, and then sees a clear path to donate. The administrator should verify that the video displays correctly, the form works in test mode, and notifications and donation records are not affected.

Preparation

Before editing, prepare the campaign title, short description, fundraising goal, campaign image, and video link. For external video, verify availability in a private browser window. For an uploaded file, check the format and size. Enable Charitable payment test mode if you plan to complete the donor flow end to end. Charitable documentation for getting started and payment gateways recommends using Test Mode before launching real donations.

Setup Steps

1. Open Charitable > Campaigns and create a new campaign or select a draft.
2. Fill in the title, short fundraising purpose, and donation amounts in the campaign settings.
3. Open the Video tab and paste the video URL or choose a file from the media library.
4. Save the campaign using the Save button or publish it, depending on the draft state.
5. Open the public page through the campaign preview.
6. Confirm that the video appears after the description and before the main action, and that the thumbnail looks appropriate.
7. Make a test donation in test mode if payments are enabled.
8. Check the record in Charitable > Donations and review email notifications if they are enabled.

This workflow is longer than the act of adding the video itself because video cannot be tested in isolation. It lives on a page where someone is deciding whether to donate. If the video works but the form fails afterward because of caching or the wrong payment mode, the campaign has still failed its purpose.

Expected Outcome

On the public page, the visitor sees a short introduction, then the video player, then the donation section and supporting campaign elements. The video starts without error, does not require account login, stays within the content width, and does not overlap the donation button. In test mode, the donation goes through, a record appears in the admin area, and the administrator knows the page is ready for a real launch once test mode is disabled.

Important detail in this workflow: if the donation form starts throwing a submission validation error after you add the video, do not assume the video caused it. First check caching on pages with Charitable forms, because Charitable’s official troubleshooting materials specifically describe security nonce failures caused by caching.

How to Configure the Page So the Video Supports Donations Instead of Blocking Them

Charitable Videos does not offer dozens of options, so the real setup work shifts into the campaign layout, Charitable settings, and the WordPress theme. The goal is to make the video build trust rather than create another drop-off point. To do that, you need to review the description length, donation form, button placement, caching, responsiveness, and player styling.

Campaign Description and Video Length

Before the video, include only what the visitor needs to enter the story. Do not place a full report above the player. If someone becomes interested, they can read the details further down the page. A strong intro answers three questions: who is fundraising, what the funds are for, and why the video is worth watching. After that kind of setup, the video feels like proof instead of a random insertion.

The ideal video length depends on the campaign topic, but short-form video usually works better on a donation page. If the organization has a long event recording, it is better to edit a separate version for the campaign. The full video can stay on YouTube or in the news section, while Charitable Videos should contain a focused message without unnecessary buildup.

The Donation Form Next to the Video

Charitable supports multiple ways of presenting campaigns: the automatically generated page, the Embed wizard, a WordPress block, or a shortcode. For Charitable Videos, that means the video may appear in different contexts: on a standalone campaign page, inside a landing page, or next to other content blocks. Check the version that will actually be published.

If the campaign is embedded on a page with many other blocks, make sure the donation form has not been pushed too far down. In some cases, it makes sense to add a separate donate button or mini Charitable widget nearby if that matches the site structure and is available in your version. But do not create competing forms with different amounts or different campaign states. The donor should see one clear path.

Caching and Pages with Forms

Charitable’s official troubleshooting guide for invalid security checks points to a common cause: cache may serve stale hidden form values, which prevents the donation from passing validation. This is especially important on campaign pages with video, because administrators often enable caching and optimization specifically to offset media weight.

Pages that contain Charitable donation forms should usually be excluded from full-page caching. That does not mean the entire site has to run without cache. In most cases, it is enough to exclude campaign URLs or the form page in the cache plugin or at the hosting level. After making that change, clear the site cache, clear the browser cache, and repeat the test donation in a private browser window.

Responsive Behavior and Player Width

The video player should be wider than the thumbnail, but never wider than the campaign container. If the WordPress theme does not define proper rules for embedded media, the player may overflow the edge of the layout on mobile. That is not necessarily a Charitable Videos issue: the extension inserts the video into the campaign structure, while the final appearance is controlled by the theme and site styles.

The safest approach is to test the campaign in the real site template where it will be published. If the site uses page builders, global containers, or a custom single-campaign.php template, review the final URL itself. Do not base your conclusion on a small preview inside the admin panel.

How to Verify the Result Before Publishing

Reviewing Charitable Videos should include more than just the player. The entire donor journey matters. The video may work perfectly, but if it makes the page slower, pushes the donation button below the fold, or leaves the form failing a security check, the campaign will lose donations. That is why it helps to use a short but strict checklist before launch.

Public Page

• The video appears after the campaign description and does not replace the goal text.
• The thumbnail is clear and does not look like an empty frame.
• The player stays within the container width on both desktop and mobile.
• The donation button or form remains easy to reach without hunting for it.
• If the video is external, it starts in a private browser window without account login.

Admin Area and Donation Data

After the visual review, run a test donation submission. In Charitable, Test Mode lets you verify the flow without a real transaction, as long as the gateway and keys are configured for testing. After the test, open Charitable > Donations and confirm that the record was created with the expected status. For some gateways, status updates may not appear instantly, so follow the documentation for the specific payment method.

Also check email notifications if they are enabled. The video itself should not directly affect email delivery, but campaign page edits often happen alongside other changes: new fields, a new theme, new caching, or a new gateway. If an email does not arrive, troubleshoot email separately rather than deleting the video without evidence.

What Counts as a Successful Launch

A successful Charitable Videos setup looks like this: the editor can replace the video without a developer, the public page shows the video in the right place, the donor understands the purpose of the campaign, the donation form works, and the administrator knows which pages are excluded from cache. The final check should be done as a normal site visitor, not from an admin session.

If the campaign matters, ask a second person to go through the page from another device. They should be able to answer three questions: did they understand the fundraising purpose, did they notice the video, and did they find the donation action? That quick user test is often more useful than another round of staring at admin settings.

Safe CSS Tweaks for the Video Player

Sometimes the video embeds correctly but still looks messy: the player is too narrow, spacing is off, or the frame breaks out of the content column. If the WordPress theme handles embedded video poorly, you can add a small CSS adjustment through Appearance > Customize > Additional CSS or through a safe snippet management tool. This is not a modification to WordPress core, Charitable, or the theme itself.

Below is a custom adjustment based on standard WordPress practices and officially documented WordPress video player classes. It does not rely on hidden Charitable Videos APIs. The selector .single-campaign only applies if your theme uses that body class on campaign pages. If your theme uses a different class, inspect it with browser developer tools or ask a developer to identify the correct page wrapper.

.single-campaign .wp-video,
.single-campaign .wp-video-shortcode,
.single-campaign iframe[src*="youtube.com"],
.single-campaign iframe[src*="vimeo.com"] {
  max-width: 100%;
}

.single-campaign iframe[src*="youtube.com"],
.single-campaign iframe[src*="vimeo.com"] {
  aspect-ratio: 16 / 9;
  height: auto;
}

After adding the CSS, clear cache and open the campaign page in a private browser window. Check it on desktop, tablet width, and phone. If the player looks correct, keep the adjustment. If the theme already defines more precise styles and the snippet creates extra spacing, remove the code and go back to the theme settings.

Do not use CSS as a substitute for proper video validation. If embedding is blocked or the file is too heavy, styling will not solve the underlying problem.

Compatibility with Themes, Blocks, Cache, and Video Hosting

Charitable Videos sits at the intersection of several parts of the site: Charitable creates the campaign, WordPress handles the video, the theme styles the page, the cache plugin speeds up delivery, and the external platform may impose embedding restrictions. That is why troubleshooting should move layer by layer.

WordPress Theme and Campaign Template

Charitable’s official documentation on custom campaign templates describes single-campaign.php as the file used to change the appearance of campaign pages through the theme or child theme. That is useful for developers, but for most sites it should not be the starting point. First check whether the standard theme outputs the video correctly. If the issue appears only in a custom theme, the most likely cause is a conflict between the player and the container, grid, or media styles.

A typical symptom is video wider than the content area, cropped output, a huge empty block, or a player overlapping nearby elements. The fix begins with checking CSS and template structure. Do not copy the campaign template just to make one small change if the issue can be solved in Additional CSS. A template override makes sense only when a developer truly needs to change the page markup itself.

Blocks, Shortcodes, and the Built-In Campaign Page

Charitable lets you display campaigns in several different ways. If you use the automatically created campaign page, the video usually lives in its standard location. If you embed the campaign via block or shortcode on a separate page, check whether content is duplicated or whether the video appears somewhere unexpected. Different display methods can come with different containers and spacing rules.

For a campaign landing page, it is usually best to choose one main path: either the dedicated Charitable campaign page or a carefully built page with an embedded campaign block. If you use both at once without clear navigation, donors may land on a page without the video or on a page with outdated campaign copy.

Cache, JavaScript Optimization, and Lazy-Loaded iframes

Optimization plugins sometimes change the load order for scripts, iframes, and forms. That may improve speed, but it can also damage the donation flow. On pages with Charitable, test the donation form first, then the video, and only after that review performance. If optimization breaks the security nonce or hides the player, exclude the campaign page or Charitable elements from aggressive rules.

Do not disable caching across the entire site unless there is a clear reason. Proper exclusion of specific pages and cache clearing after campaign changes is usually enough. If your host uses server-side caching, check the hosting control panel or contact support. It is important to remember that an administrator may be seeing the latest version while a regular visitor is still getting a stale cached page.

Video Hosting and Embedding Restrictions

YouTube, Vimeo, and other platforms can change video availability independently of WordPress. If the video worked yesterday but shows an error today, check the video directly on the platform. The owner may have disabled embedding, changed privacy settings, deleted the file, enabled age restrictions, or limited playback by domain. For time-sensitive campaigns, it is best to have a fallback plan in advance: another URL, a short text substitute, or an uploaded version of the video if rights allow it.

Core Charitable Videos Behaviors Worth Understanding

This extension does not have many visible settings, but it does have a few behaviors that determine how it actually works. Once you understand them, troubleshooting becomes faster and campaign pages become more stable.

Behavior 1: The Video Is Attached to the Campaign, Not the Site Globally

The configuration point is the editor for a specific campaign. The user enters a URL or selects a file. The product stores that value as part of the campaign data and displays it on the public page. The visible outcome is a player that appears inside the campaign structure. The way to verify it is to open that campaign, not some other page on the site. A failure symptom is that one campaign has video while another does not. The fix is to add the video separately to the correct campaign. The limitation is that Charitable Videos documentation does not describe any global mass setting for one video across all campaigns.

Behavior 2: The Extension Does Not Need a Separate Settings Page

The configuration point is the Video tab inside the campaign. The user does not choose global styles or player behavior there. The product does one job: it links a video to a campaign. The visible outcome is a simple admin workflow without extra menus. A failure symptom is that the administrator goes looking for a separate menu item and assumes the extension did not install. The fix is to check the campaign editor and the active plugins list. The limitation is that fine-grained visual control usually happens through the theme, CSS, or the campaign template.

Behavior 3: An External URL Depends on WordPress Embeds

The configuration point is the URL field in Video. The user pastes a normal link to the video. The product relies on WordPress being able to embed the supported source. The visible outcome is the external platform’s player on the campaign page. Verification means opening the video in a private browser window and then checking the campaign page. A failure symptom is a blank block, a platform message, or a missing player. The fix is to review privacy settings, embedding permissions, and source support. The limitation is that Charitable Videos cannot force a third-party platform to allow embedding.

Behavior 4: An Uploaded File Shifts the Delivery Load to the Site

The configuration point is uploading the file through the Video field or the media library. The user selects a file that the site itself will serve. The product outputs the video through WordPress media features. The visible outcome is an embedded player with no external platform involved. Verification means opening the page as a normal visitor and assessing how quickly playback becomes available. A failure symptom is a slow above-the-fold area, stuttering playback, or a format error. The fix is to compress the video, choose a supported format, or move to an external video host. The limitation is that the extension does not turn WordPress into a full video delivery platform.

Behavior 5: The Video and the Form Must Be Tested Together

The verification points are the public campaign page and Charitable > Donations. The user starts the video and completes a test donation. The product should display the video, accept the form, create a record, and send notifications if they are enabled. A failure symptom is that the video works but the form throws a validation error or fails to create a donation record. The fix is to check Test Mode, cache, the gateway, and conflicts with the theme or other plugins. The limitation is that the video embed itself does not diagnose payment gateways or email.

How to Use Video Alongside Other Charitable Features

Video rarely stands on its own. It usually supports the donation form, campaign widget, fundraising goal, updates, and email flow. A strong setup does not feel like a pile of extensions. It feels like one coherent story: the visitor sees proof, understands the amount, chooses an action, and receives a clear follow-up email after donating.

Video Plus Goal and Campaign Progress

If the campaign has a specific amount goal, the video should explain why that target matters. It does not need to mention every number in the video itself, since those figures may change. It is better to show what work or outcomes become possible after the funds are raised. On the page, Charitable can display the goal and progress next to the video, while the campaign copy fills in the details.

The check is simple: after watching, the donor should understand why a donation matters right now. If the campaign progress shows that the goal is almost reached, the video may help drive the final push. If the fundraiser is long-term, the video usually works better when built around ongoing impact rather than urgency.

Video Plus Updates

Charitable documentation describes Simple Updates as a way to publish campaign progress messages on the page. Paired with Charitable Videos, this creates a useful structure: the main video explains the mission, and the updates show progress over time. You do not need to replace the video with every new update. It is enough to keep the main video current and use text for the ongoing details.

If the campaign runs for a long time, schedule a review of the video. An older video saying "we are just getting started" feels out of place next to updates that already show results. In that case, replace the video or add a short note in the text explaining that the video tells the original campaign story while the latest progress appears in the updates.

Video Plus a Separate Form or Mini Widget

Charitable can display forms and widgets in different places across the site. If you are building a long landing page, you can keep the video inside the campaign and place a compact donation path near the supporting materials. The key is not to mix different campaigns or send the user into an unexpected flow. Every element should support the same fundraising goal.

This approach works well for project story pages: the video at the top, a detailed story underneath, and then a donation section or link to the campaign. Charitable Videos handles the campaign’s media element, while the rest of Charitable helps shape the donor journey around it.

Maintaining the Campaign After Publication

Adding the video once is not enough. A campaign may remain live for weeks or months, and the video can gradually become outdated. The target amount changes, reports are published, new photos appear, some needs are already covered, and certain wording no longer fits the current stage. If the page keeps showing an old video with no explanation, donors may feel that the campaign is no longer being updated.

Charitable Videos makes replacement easy: go back into the campaign, change the URL or file, and save. But before replacing anything, you need to be clear about what exactly is changing. There is no need to swap the video out every time a minor update happens. Campaign updates are better for day-to-day developments, while the main video should change only when the fundraising story, goal, project stage, or proof of trust has materially changed.

When to Replace the Video

The video should be replaced if it promises an action that has already been completed, shows an outdated goal, contains an outdated date on screen, refers to a finished phase, or no longer matches the public campaign copy. For example, the video may say the organization is still looking for a space, while the page already shows renovation photos. In that case, the donor sees a contradiction and may start doubting the page as a whole.

If the video remains emotionally strong but some details are out of date, you can keep it and add a short explanation in the campaign text or Updates. For example: the main video tells the original story of the project, while current progress appears below. But that note needs to be honest and visible, otherwise it does not solve the problem.

How to Replace the Video Safely

1. Save the old URL or filename in the campaign working document.
2. Prepare the new video and verify its availability before editing the campaign.
3. Open the campaign in Charitable and replace the value in the Video tab.
4. Save the changes and clear page cache if caching is in use.
5. Open the public page as a logged-out visitor.
6. Check the video, donation form, and test donation record if campaign settings changed as well.

Rollback is just as simple: restore the previous URL or file and save the campaign again. If the problem was in the new video itself, do not change the theme, cache plugins, and form settings at the same time. Otherwise, you will not know which change actually broke the page.

How to Monitor Quality After Launch

After publication, do not focus only on the donation total. Review user questions, support requests, page traffic, load speed, and playback complaints. If donors keep asking about something the video is supposed to explain, the message may be too general or placed too low on the page. If the page gets traffic but few donations, check whether the player is pulling too much attention or whether the form is buried.

A simple team process helps: every time the campaign gets a major update, review the video, thumbnail, text before the video, form, and cache behavior. That takes less time than repairing the page after complaints. A video campaign is truly current only when the media, text, form, and reporting all tell the same story.

Troubleshooting: When the Video Does Not Appear or the Page Becomes Unstable

Problems with Charitable Videos are easiest to diagnose in layers: video source, campaign field, WordPress embeds, theme, cache, and donation form. Do not start by reinstalling the extension until you have checked the simplest causes first.

The Video Did Not Appear After Saving the Campaign

Symptom: the URL or file is present in the admin area, but there is no player on the public page. Possible cause: you are looking at the wrong page, cache is serving an older version, the campaign is not published, or the campaign is being displayed through a different method. Check the campaign status, preview that exact campaign, clear cache, and open the page in a private browser window.

If the video appears after clearing cache, add the campaign page to exclusions or refine your cache rules. If it still does not appear, replace the URL with a simple public YouTube video to test the mechanism. If the test video displays correctly, the issue is in the original video or its platform settings.

The Player Shows an Error from the External Platform

Symptom: instead of the video, you see a message about restrictions, privacy, unavailability, or blocked playback. Possible cause: the video owner disabled embedding, made the video private, added age restrictions, or limited it by region. Open the video in a private browser window and review the embedding settings on the platform itself.

The fix is to change the video privacy, allow embedding, or choose another source. If the organization does not control the video, it is better not to rely on it as a critical campaign element. A fundraising page should remain stable even when an outside publisher changes settings.

An Uploaded File Starts Slowly or Makes the Page Heavy

Symptom: the campaign page opens slowly, the video takes a long time to load, and mobile users report freezing. Possible cause: a heavy file, weak hosting, poor media delivery, or an unsuitable format. Check the file size, duration, format, and overall page load speed.

The fix is to compress the video, switch to a more common format, use an external video host, or deliver media through a CDN. If the campaign gets traffic from email blasts, do not serve a large video file from ordinary shared hosting without testing the load first.

The Player Breaks the Campaign Layout

Symptom: the iframe extends beyond the width, overlaps nearby blocks, leaves a large empty area, or looks badly proportioned. Possible cause: the WordPress theme or custom campaign template does not define proper rules for embedded media. Check the page in a default theme or temporarily disable conflicting styles in a test environment.

The fix is to add careful CSS for player width, inspect the single-campaign.php template, and remove aggressive page builder styles. Rollback means removing the CSS adjustment or restoring the original child theme template. Do not edit Charitable Videos files directly.

After Adding the Video, the Donation Form Shows a Validation Error

Symptom: the video is visible, but donation submission ends with a message saying the form submission could not be validated. Charitable documentation connects these security check errors primarily to cached hidden form values or conflicts with the theme and plugins. Check cache exclusions for form pages, clear hosting and browser cache, and run the test again.

If the error remains, disable conflicting optimizations one at a time in a test environment. Charitable’s official article mentions a snippet as a last-resort way to reduce validation checks, but it explicitly frames that path as not recommended. For a normal site, the better fix is to correct the cache or conflict rather than weaken form validation.

The Video Appears in Preview but Not on the Published Page

Symptom: the administrator sees the video in preview, but a regular visitor does not. Possible cause: cache, video privacy settings, file access permissions, or a difference between the draft and the published page. Check the URL as a logged-out user, clear cache, and confirm that the video is available without an account.

The fix depends on the cause. For external video, change the access settings. For an uploaded file, check the media library and file permissions. For cache, exclude the campaign page. For draft issues, publish the changes or make sure you are opening the current live URL.

When Charitable Videos Is the Right Choice

Charitable Videos is a strong fit if the site already runs on Charitable, the campaign has a compelling visual story, and editors need a simple way to add video without writing iframe code by hand. The extension is especially useful for nonprofits, schools, church fundraisers, local initiatives, and volunteer projects where trust comes from a real human explanation, not just from written copy.

Before launch, verify the video source, public availability, player position, mobile layout, page cache behavior, and a test donation. If everything works, you can move on to the download block and download the Charitable Videos package for use on your site. After installation, do not stop at the fact that the player appears: make sure the video actually helps a visitor understand the fundraising goal and donate without unnecessary friction.

If you need a full donation platform migration, compare Charitable against GiveWP, Donorbox, and Paymattic across the entire stack: forms, gateways, reporting, donor data, recurring donations, support, and total cost of ownership. But if the task is specific - add video to a Charitable campaign while keeping management inside WordPress - Charitable Videos handles it in a direct and practical way.