Watch a live product demo 👀 See how Sanity powers richer commerce experiences

How to Add a Link to an Image in PortableText Editor

13 replies
Last updated: Aug 11, 2022
Question about links. I've setup links similar to this post: and that is fine with one drawback, how to add a link to an image? I'm currently importing a wordpress blog and ran into this limitation. Is there a recommended way to link an image that works in the portableText editor with annotations?
Aug 11, 2022, 9:21 PM
Would this be an image in your dataset or an image hosted outside of sanity?
Aug 11, 2022, 9:22 PM
I'm importing the images into sanity as I go, using block-tools. So it would be an image I import. Creating ldjson as I go through the html.
Aug 11, 2022, 9:23 PM
I guess I could add a link option on my media types, just wondering if there is a better way.
Aug 11, 2022, 9:25 PM
not really hard to check if the link child is an image in the processing, block-tools is super cool
Aug 11, 2022, 9:26 PM
Ah, got it. I understand. If you're adding the image to your dataset, could you just add it to your array of blocks like in this example? You could then use conditionals in your query to expand the asset on your frontend.
Aug 11, 2022, 9:29 PM
But how would you attach a link, e.g <a href="some external url"><img src="sanity image asset" /></a>?
Aug 11, 2022, 9:37 PM
only thing I can think of is a custom image object with a link option but the portableText UI wouldn't be used to manage the linking. It would have to be set when the image is inserted from the popup
Aug 11, 2022, 9:38 PM
Ok, I think I misunderstood. Is the idea to a) set a link and b) set an image that will represent that link on the frontend?
Aug 11, 2022, 9:39 PM
If so, you can add a field to your image object for that url:
  name: 'image',
  type: 'image',
  fields: [
      name: 'link',
      type: 'url',
      options: {
        isHighlighted: true
Aug 11, 2022, 9:41 PM
yeah, the wordpress site I'm imported uses images linked to youtube videos. So I want to maintain that on import.
Aug 11, 2022, 9:41 PM
fair enough, I'll go that route. It was my initial plan but wasn't sure if there was a better way.
Aug 11, 2022, 9:42 PM
thank you
Aug 11, 2022, 9:43 PM
Happy to help!
Aug 11, 2022, 9:43 PM

Sanity– build remarkable experiences at scale

The Sanity Composable Content Cloud is the modern headless CMS that treats content as data to power your digital business. Free to get started, and pay-as-you-go on all plans.

Related answers

Get more help in the community Slack

TopicCategoriesFeaturedRepliesLast Updated
After adding the subtitle and running this code npm run graphql-deploy It does nothingSep 15, 2020
how to limit a reference to just one entry in Studio reference input side versus the default as-many-entries-as-you-fill-in-an-array...Sep 18, 2020
Is it possible to fetch more than one "_type" using GROQ?Nov 2, 2020
I want to add a view with the Structure builder (S.view.component) where I list similar documents based on the title. What...Sep 23, 2020
Is there a structure builder example where the format of each preview for the document list is modified?Feb 3, 2021
I have an array of references to a country schema type but it always just returns NULL values for meJan 30, 2021
Hi, I need help with a query for getting the url of an image asset. Here is what I've been trying, but I only get the _ref...Dec 1, 2020
Sanity UI looks brilliant :smiley: Is something like the current date picker possible at the moment? I’m not sure if anicon...Dec 21, 2020
Hey everyone. I have been coding and may have potentially accidentally deleted something. Does anyone know how to resolve...Dec 26, 2020
Hello everyone and happy new year :raised_hands::skin-tone-2:, I have a problem with outputting Portable Text :disappointed:...Jan 1, 2021

Related contributions

Clean Next.js + Sanity app
- Template

Official(made by Sanity team)

A clean example of Next.js with embedded Sanity ready for recomposition.

Cody Olsen
Go to Clean Next.js + Sanity app

Blog with Built-in Content Editing
- Template

Official(made by Sanity team)

A Sanity-powered blog with built-in content editing and instant previews.

Go to Blog with Built-in Content Editing