Blog - Knowledge in Practice

Strapi Media Embeds: Images, Video and Audio

Use Strapi to manage page content and a suitable media service to deliver video, audio and reusable embedded collections.

Originally published 27 August 2025. Updated 5 November 2026.

Strapi Media Embeds: Images, Video and Audio

Use an embed as a maintained knowledge surface

For documentation and product education, the useful unit is often a maintained collection rather than a media file attached to one page. Strapi can hold the article structure and the approved embed reference, while a media platform handles delivery and the collection's presentation. Keep editorial ownership and media ownership clear so an update does not require a different upload in every article.

Begin with a normal responsive embed, then test publishing, consent controls, keyboard access and the behavior of the surrounding application. Add captions, descriptive titles and supporting documents where they help the task. If the experience includes library-wide questions, scope the knowledge sources and audience access deliberately instead of treating arbitrary embedded content as trusted documentation.

What Strapi already provides

Strapi’s Media Library manages uploaded assets and supports image optimization and responsive image sizes. Its current documentation describes configurable breakpoints and provider options. A dedicated media workflow should address a specific delivery or editorial requirement rather than assume Strapi has no image-processing features.

Image breakpoints and video transcoding are different capabilities. Decide which system stores the approved source, which generates the required formats and which delivers playback to the audience.

Choose the integration pattern

For an editor who needs to upload and associate Cincopa media inside Strapi, Cincopa's setup guide documents a Strapi v5 uploader plugin. For media already published elsewhere, a content model can instead hold an approved reference that the frontend renders using the intended media workflow.

Choose the pattern around the team's source of truth. Avoid uploading a second unmanaged copy of a product explanation merely because another page or collection needs to use it.

Connect the Cincopa Uploader in Strapi

Follow the Cincopa and Strapi integration guide for the current package, JavaScript or TypeScript configuration, API-token setup and webhook endpoint. The guide documents the strapi-plugin-cincopa-uploader package for Strapi v5.

Keep the Cincopa API token in the server-side environment and plugin configuration. Do not paste it into a public content entry or browser code. Confirm the required permissions and the webhook setup for the actual environment.

Restart the application after changing configuration, then test one representative upload and its processing status. Verify the editor permissions and the relationship between the uploaded media and the intended collection entry before enabling a wider workflow.

Model the media and render it in context

Give the content entry a clear media reference and any explanatory text the page needs. Keep descriptive titles, useful alternative text for images and the relevant captions or transcript workflow alongside the source.

The frontend should use the approved player or embed method and the intended access rules. Do not assume that a generic file URL provides adaptive video playback, captions or the same protection as a configured media experience.

Test the rendered page on the audience's devices. Check legibility, captions, playback and the behavior of a viewer who should be denied access. Confirm that an expiring URL will not be stored as an enduring public reference without a renewal workflow.

Reuse product explanations and keep them current

A maintained demonstration can serve a product page, a support article and an onboarding resource. Connect those destinations to the approved source and review the surrounding instructions when the source changes.

Cincopa Galleries, Pages and Tube provide different collection experiences. VideoGPT can support questions across approved videos and documents in the chosen knowledge experience. The Strapi uploader alone should not be described as automatically adding every one of those experiences to a frontend.

Source documentation

Strapi Media Library documentation explains native image settings, responsive breakpoints and provider configuration.

Cincopa’s Strapi integration guide contains the maintained setup instructions and interface examples.

Frequently asked questions

Yes. Strapi documents responsive image generation and configurable breakpoints. Check the current settings and provider behavior; changes to breakpoints apply to new uploads rather than automatically regenerating every existing image.

Not necessarily. Verify the chosen processing, playback and delivery workflow separately from the ability to upload a file.

Use the server-side environment and plugin configuration described in the integration guide. A secret token should not become a public content field or client-side variable.

NEXT STEP

Give your media a reusable knowledge home

Keep video delivery and source ownership clear, then connect approved explanations to the places people work.