Upload Image/Video/File using Form Data DotNet Web API
Shehryar Khan
Shehryar Khan
April 03, 2022
1 min

Table Of Contents

Uploading Image in Web API Controller
How to Use WWWROOT Directory
Testing File Upload using Postman
Uploading Image using Model in Web API Controller


DotNet Web API provides a very simple way to Upload Image, Video or any type of File. I do receive emails that people are facing issue while writing Web API for uploading any File Type using .Net 7 or any previous version e.g. .Net 6 or .Net Core.

They’re 2 most common ways of uploading image using .Net Web API.

  1. Uploading image using FormData (FromForm)
  2. Uploading Image using Bytes Array (FromBody)

In this article you’ll check the first one, which is uploading image using Form Data.

There are more than one way of uploading Files using ASP.Net Core or .Net Web API. We can also get bytes stream, convert into image or save in wwwroot folder. The other way of doing this is even more simpler. When we receive Image or File using Form Data then It’s really simple to save that file.

Uploading Image in Web API Controller

First of all we need to create images folder inside wwwroot folder.

Here’s our code.

public string UploadImage([FromForm]IFormFile file)
        // getting file original name
        string FileName = file.FileName;

        // combining GUID to create unique name before saving in wwwroot
        string uniqueFileName = Guid.NewGuid().ToString() + "_" + FileName;

        // getting full path inside wwwroot/images
        var imagePath = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot/images/", FileName);
        // copying file
        file.CopyTo(new FileStream(imagePath, FileMode.Create));

        return "File Uploaded Successfully";
    catch (Exception ex)
        return ex.Message;

How to Use WWWROOT Directory

If you don’t have wwwroot directory in your project, it’s really simple to add.

Just add the below line in your Configure Action of your project’s Startup.cs File.


Now create a new Folder as wwwroot at the root of your project.

Testing File Upload using Postman

We need to select form-data parameter to upload image/file. We’ll select POST method because we have written a POST Web Service. Make sure that you are sending file with the exact name that you are receiving file in your API.

dotnet web api form data

You can see that File has been successfully Uploaded.

If you want to send some more parameters with File, Here’s your solution.

Uploading Image using Model in Web API Controller

Sometimes we need to send some other parameters with file as well. For achieving this we need to create a custom Model. Here’s our Model

using System;
using Microsoft.AspNetCore.Http;

public class UserModel
    public int Id { get; set; }

    public string Name { get; set; }
    public string Address { get; set; }
    public IFormFile Image { get; set; }

Now we can USE this Model instead of single File.

public string UploadImage([FromForm]UserModel data)

You can access your data using data object, e.g. data.Name, data.Address, data.Image

That’s all for now. Thank you for reading the article. If you have any question, Please ask in the comment section below.

Related Articles:

JWT Authentication Configuration in .Net 7

Best Windows VPS (Virtual Private Server) in 2022 – Top 5


Shehryar Khan

Shehryar Khan

Full-Stack .NET Developer

I'm passionate about learning new technologies as well as mentoring and helping others get started with their programming career. This blog is my way of giving back to the Community.



Social Media


Related Posts

Let’s Ready a .Net Core Web API Project
April 03, 2022
3 min
© 2023, All Rights Reserved.

Quick Links

Advertise with usContact Us

Social Media