Wix Blog API: How to set featured image (post cover) alt text via draftPosts.updateDraftPost?

Ask the community
, , , ,
1

Hi everyone,

I’m programmatically creating and publishing Wix Blog posts using Velo (wix-blog-backend, draftPosts.createDraftPost + publishDraftPost).

Everything works except setting alt text for the featured image (post cover media).

Important clarification:

  • I am not referring to heroImage

  • I am referring to the featured image / cover media of the blog post

What works

Setting the featured image itself works only when using the Wix URI format:

wix:image://v1/<mediaId>~mv2.png/<filename>#originWidth=700&originHeight=500

Example:

wix:image://v1/f1e6fe_...~mv2.png/Thumbnail.png#originWidth=700&originHeight=500

The image is applied correctly to the post.

What does NOT work

According to the docs, updateDraftPost supports:

media:
  wixMedia:
    image: string

But:

  • The image field is a string

  • There is no documented way to attach altText

  • Adding altText as an object property is ignored

  • Adding it as part of the URI does not work

  • Query params like #watermark= do not affect alt text

Question

:backhand_index_pointing_right: Is it currently possible to set alt text for a blog post’s featured image via the Blog API?

If yes:

  • What exact string format is expected?

  • Is alt text supported in the wix:image://v1/... URI?

If no:

  • Is this a known limitation of the Blog API?

Why this matters

  • Accessibility (screen readers)

  • SEO best practices

  • Fully automated publishing pipelines

I’m happy to accept that this is not supported yet — I just want to confirm the correct approach.

Thanks in advance :folded_hands: