Skip to main content

Software Development

You Just Got Vectored! SVG Image Formats

3d Sound Waves With Colored Dots. Big Data Abstract Visualization.

If you’re reading this, you’ve come across a need that nearly all Opti developers encounter in their careers; You need to correctly display a vector image format (SVGs and the like). The <IMG> tag just isn’t going to cut it anymore. Posts like this are a right-of-passage for Opti bloggers.

“So,” you think, “if there are so many other blogs on the topic, why should I read yours?” Firstly, you enjoy my familiar and conversational tone of writing.

Cary Elwes does the English accent, and I do the nerd stuff.

Second, you’ve already come this far; you might as well finish at this point; it’s not long, I promise. To that point, and most importantly, I’ve seen some complex solutions out there. This one is a quick and straightforward implementation. 100% Guarantee!

The VectorFile Class

[MediaDescriptor(ExtensionString = "svg")]
public class VectorFile : ImageData
   public override Blob Thumbnail { get => BinaryData; }

   public virtual string XML
            var blob = BinaryData;
            var xmlDoc = new XmlDocument();

            return xmlDoc.InnerXml;
            return "";


This delightful little class will extract the thumbnail for previews and place the image in an XML document that can be inserted into a view as a <SVG> tag. You can see from the MediaDescriptor attribute that we’re only allowing .SVG files here. This list can be expanded as needed. This is where you can also supply different properties regarding your SVG in the class; it’s just content!


The VectorFileController Class

public class VectorFileController : AsyncPartialContentComponent<VectorFile>
   protected override async Task<IViewComponentResult> InvokeComponentAsync(VectorFile currentBlock)
      return await Task.FromResult(View("~/Features/Media/_vectorFile.cshtml", currentBlock));


This should look familiar to CMS12 block development, just your run-of-the-mill controller. No tricks, no fills.

The VectorFile View

@model VectorFile

@if (Model != null)


Many devs would have you use @Html.Raw to put the SVG code on the screen, but with the MarkupString struct. We are on less shaky ground here because MarkupString is parsed in an HTML or SVG format rather than trusting that the silly SVG you grabbed off Pinterest for that company party doesn’t have some nasty embedded code.
Now, on the next upload to your Media folder, any SVG file should appear as a VectorFile instead of an ImageFile! (You did take the .svg extension out of the MediaDescriptor of your raster image class, right?)
Told you it would be short and simple! Happy coding Opti-mists!

Leave a Reply

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

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Greg Jeffers, Senior Technical Consultant

Greg Jeffers is a Senior Technical Consultant with Perficient. He has been developing software on the Microsoft stack for 20+ years and working with Optimizely for 5. Having been in several roles across multiple industries, Greg brings a holistic approach to development. He is passionate about finding the right balance of people and processes to make users feel comfortable in the application while being performant.

More from this Author

Follow Us