Heisy – AI Product Videos for WooCommerce

FAQ

Is Heisy free?

The plugin is free to install, and nothing in it is locked. The videos are made on the Heisy service, which needs a paid plan with monthly credits; see heisyai.com/pricing. A render that fails gives its credits back automatically.

Do I need WooCommerce?

No. Heisy works from any image in your Media Library. With WooCommerce active, you can also start from a product and show its video on the product page.

Where are my videos stored?

In your own Media Library, as MP4 files, like any other upload. They are yours to use on the product page, on social media or in ads.

What data leaves my site?

The image you render from, the product’s name and description, and the settings of each render, sent to the Heisy API at heisyai.com. See External services above for the full list.

How do I show a product’s video on its page?

First give the product a video: on the product’s edit screen, pick a render in the Heisy video box (or press Use on product on a render in Heisy → All renders).

Then choose where it appears. There are four ways, and you only need one:

1. Automatically. Heisy → Settings → Store → Where it shows sets a place for every product: above the gallery and summary, or under the gallery thumbnails. A single product can choose differently in its Heisy video box → Where it shows. This uses WooCommerce’s standard product page; themes that draw their own product page should use one of the options below instead.
2. A block. In the block editor or a block theme’s product template, add the Heisy product video block.
3. A shortcode. Put [heisy_video] in any block, widget or template that supports shortcodes.
4. Your theme’s code, with the template functions below.

Each of them shows the video of the product being viewed, and prints nothing for a product without one. So the same template line can go on every product page.

The video shows even though I chose “Only where I place it”

That setting stops Heisy adding the video by itself. It does not remove a [heisy_video] shortcode, a Heisy block or a heisy_video() call that is already in your theme or page — those are the “places” it means. If your theme’s product template contains one, every product with a video shows it there.

To hide the video on one product, pick None in the video list of its Heisy video box.

Shortcode options

[heisy_video] — the video player for the product being viewed.

• product="123" — show another product’s video.
• autoplay="0" — do not start by itself (default 1: plays muted, as browsers require).
• loop="0" — play once (default 1).
• controls="1" — show the play/pause bar (default 0).
• class="my-class" — an extra CSS class on the <video>.

Example: [heisy_video autoplay="0" controls="1" class="product-film"]

[heisy_video_url] — only the video's address, for your own markup or a custom field. `product="123"` works here too.

Template functions (PHP)

heisy_video( $product_id = 0, $atts = [] ) returns the <video> markup, heisy_video_url( $product_id = 0 ) returns the address. 0 means the product being viewed. Both return an empty string when the product has no video, so check before printing a wrapper:

<?php if ( function_exists( 'heisy_video_url' ) && heisy_video_url() ) : ?>
    <div class="product-video">
        <?php echo heisy_video( 0, [ 'controls' => true ] ); ?>
    </div>
<?php endif; ?>

Template functions (Twig / Timber)

Timber exposes PHP functions through function():

{% set video_url = function('heisy_video_url') %}
{% if video_url %}
    <div class="product-video">
        {{ function('heisy_video', 0, { controls: true }) }}
    </div>
{% endif %}

Or with the shortcode:

{{ function('do_shortcode', '[heisy_video]') }}

Does the video URL follow my CDN?

Yes. The shortcode, the block and both functions ask WordPress for the address of the video and of its poster image every time the page is built (wp_get_attachment_url()), which is what CDN and offload plugins rewrite. The exception is a URL copied from the Heisy video box and pasted into a page by hand: that text stays as it was, so prefer the shortcode or the functions. If your product pages are cached, a new video appears once that cache is cleared.