Images, UI

Learning about Embedded Images in Xamarin Forms

Hello everybody! I hope that you all had excellent Christmas & New Year parties and had a great time with your loved ones! 💚💕Now is the time to continue learning!  (Voice saying yes 😎) In this article will be learning about Embedded Images.

So… 💭 I imagine that at some point in your developer life when you are adding images to your Xamarin project you ask to yourself something like a  “Isn’t there a faster way to add the images in to my project without having to add them on each platform? 🤔” The answer is YES!  And that’s what we’ will learn today !! Let’s see!


First, let’s clarify the following points 

✔ What exactly are Embedded Images?

Like a a local Images, Embedded images are shipped with an application but it has the peculiarity that these are not contained in each application’s file structure, but file is embedded in the assembly project as a resource.

Removing the time we take converting our images into the formats required by each platform and then adding them, we’ll save development time and make our project lighter!

⚠ It’s important to know that this kind of image distribution is useful only if the images are used are identical for every platform.


Let’s start!!! 😍

The first thing we have to do, is to add your needed images in to your Xamarin Forms project:

1⃣. Add folder preferably named “Images” (It’s not mandatory but it is good practice and makes your project more understandable and organized)

2⃣. Once image added, make a right click on your image and do the following steps:

➖ Go to Properties

➖ In the Build Action property, add EmbeddedResource as value.

Once image added, let’s create a class, in this case it will be named ImageResourceExtension.cs.  This is a XAML Markup Extension class, it help to extend the power and flexibility of XAML by allowing element attributes to be set from sources other than literal text strings. If you want to read more information about this topic, you may want to click here.


Now, let’s use it in our XAML!

As the image was added in the Xamarin root project, let’s add a namespace to refer to out local resources:

Then, just add an Image tags with the following structure:

This image has an empty alt attribute; its file name is EmbeddedImgStruture.png

Translating into code, it’s just like this:


And finally, the result!

This image has an empty alt attribute; its file name is EmbeddedImages1-1024x739.png

Done! Our Embedded Image is added! 😍

Thanks for reading!!! 💚💕


Spanish post: https://medium.com/@reyes.leomaris/aprendiendo-sobre-embedded-images-en-xamarin-forms-bae6daa2c24c?sk=4ad7f5dacedc446ea35b400d35cd3a42

References: https://channel9.msdn.com/Shows/XamarinShow/XamarinForms-101-Using-Embedded-Images

https://docs.microsoft.com/en-us/xamarin/xamarin-forms/user-interface/images?tabs=windows&WT.mc_id=xamarin-c9-maleger#embedded-images

Tagged , ,

1 thought on “Learning about Embedded Images in Xamarin Forms

Leave a Reply

Your email address will not be published. Required fields are marked *