# How can I set featured image via Write API?

**URL:** <https://forum.builder.io/t/how-can-i-set-featured-image-via-write-api/15988>\
**Category:** Technical Questions\
**Tags:** api\
**Created:** [November 27, 2025, 6:02pm UTC](https://forum.builder.io/t/how-can-i-set-featured-image-via-write-api/15988 "2025-11-27T18:02:45Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![feng](https://avatars.discourse-cdn.com/v4/letter/f/82dd89/32.png) [@feng](https://forum.builder.io/u/feng)\
**Post date:** [November 27, 2025, 6:02pm UTC](https://forum.builder.io/t/how-can-i-set-featured-image-via-write-api/15988/1 "2025-11-27T18:02:45Z")

</div>

**Builder content link**

> **[Builder.io: Visual Development Platform](https://builder.io/content/7666387c7f874e5796778896d3835e20)**
>
> Builder is an AI-Powered Visual Development Platform that helps teams generate, iterate, and optimize web and mobile experiences in seconds instead of sprints.

**Builder public api key**  
_I am using **Write API** to update blog post._

**What are you trying to accomplish**  
_I want to set **featured image** from external URL via API._

I have tried several ways but neither worked.

```auto
# way 1
{
  data: {
    featuredImage: url
  }
}

# way 2
{
  data: {
    featuredImage: {
      url: url
    }
  }
}

```

Can you please help me how I can set **featured image**?

---

<div class="post-metadata">

**Author:** ![manish-sharma](https://avatars.discourse-cdn.com/v4/letter/m/8797f3/32.png) [@manish-sharma](https://forum.builder.io/u/manish-sharma)\
**Post date:** [December 4, 2025, 11:24am UTC](https://forum.builder.io/t/how-can-i-set-featured-image-via-write-api/15988/2 "2025-12-04T11:24:41Z")

</div>

Hello @feng,

For the `featuredImage` field, you can set it by passing the value as a plain string in the Write API request. The correct format is:

```json
{
  "data": {
    "featuredImage": "your-image-url-here"
  }
}

```

You don’t need to wrap it in an object—just provide the string directly.
