urls-to-data.html

---
layout: default
title: URLs for Linking to Data
menu-id: l1-web
pdfs:
    - urls-data.pdf
---

<p>Since the 4.4.4 release of OMERO, the OMERO.web client has supported direct
linking to Projects, Datasets, Images etc. using a URL of this form:</p>

<div class="code-example">/webclient/?show=&lt;datatype&gt;-&lt;id&gt;</div>

<p>For example, to link to Dataset 314 on OMERO.web hosted at:</p>

<div class="code-example">http://yourdomain.example.org/omero/webclient</div>

<p>the full URL will be:</p>

<div class="code-example">http://yourdomain.example.org/omero/webclient/?show=dataset-314</div>

<p>This URL is supported for the following data types:</p>

<ul class="bullet-list">

<li>project.</li>
<li>dataset.</li>
<li>image.</li>
<li>screen.</li>
<li>plate.</li>
<li>tag.</li>
</ul>

<p>The OMERO.web client will navigate to the specified object, regardless of what containers it is in. It will also switch the web client to the correct Group and User (so it will work for any user who has permission to see the object).</p>

<p>For example, if you create a link to an Image, this will be valid even if you move the Image to a different Dataset and/or move it to a different Group.</p>

<p>You can find this URL when viewing any object by clicking on the &#8216;link&#8217; icon
in the right-hand panel.</p>

<div class="line-block">
<div class="line"><br /></div> <!-- end #line -->
</div> <!-- end #line-block -->

<img alt="{{ site.baseurl }}/images/webclientGeneral2.jpg" class="align-center" src="{{ site.baseurl }}/images/webclientGeneral2.jpg" style="width: 75%;" />

<div class="line-block">
<div class="line"><br /></div> <!-- end #line -->
</div> <!-- end #line-block -->

<p>Multiple objects are also supported using the <span class="code-example">|</span> symbol, as long as they are in the same container.</p>

<div class="code-example">webclient/?show=image-2451|image-2452</div>

<p>This will select 2 Images assuming the second one is in the same Dataset as the first. You can generate this URL by clicking on the &#8216;link&#8217; icon when multiple objects are selected.</p>

<div class="line-block">
<div class="line"><br /></div> <!-- end #line -->
</div> <!-- end #line-block -->

<div class="line-block">
<div class="line"><br /></div> <!-- end #line -->
</div> <!-- end #line-block -->

<div class="page-end">
<p>All Tutorial Material is available on line at: <a href="http://help.openmicroscopy.org">www.help.openmicroscopy.org</a></p>
<p>The Main OME website is at: <a href="http://www.openmicroscopy.org">www.openmicroscopy.org</a></p>
</div> <!-- end page-end -->