# Source: https://stately.ai/docs/image.mdx

# Share machine images using their image URL (/docs/image)
import { LinkIcon, MoreHorizontal } from 'lucide-react';

You can share an image of your machine anywhere that supports images. You can use the image URL for live-updating images where the machine is always updated with your latest changes. Machine images can be helpful in documentation, including GitHub pull requests.

The machine below demonstrates the copy image URL flow.

<EmbedMachine name="Copy image URL flow" embedURL="https://stately.ai/registry/editor/embed/1b050e43-c8a5-4e28-b881-71eadcc5b8a1" />

Your machine image will only be available if:

* the project visibility is **public** or **unlisted**

Machine images are not available for private machines.

Read [how to change a projectâs visibility settings](projects.mdx#change-a-projects-visibility).

<Callout>
  You can also [embed your machine](embed) for a focused non-editable view of your machine in Stately Studioâs editor.
</Callout>

## Copy the image URL

Use the <LinkIcon size={16} /> **Copy image URL** option from the <MoreHorizontal size={18} /> triple dot icon alongside your machine name.

## Color mode

By default, the imageâs color mode will be the same as your chosen Stately Studio color mode. Add `.light.png` or `.dark.png` to the URL to force that color mode.

## Examples

The examples below show how you can use the image URL.

### Markdown

```md
![State machine for the copy image URL flow in light mode.](https://stately.ai/registry/machines/1b050e43-c8a5-4e28-b881-71eadcc5b8a1.light.png)
```

### HTML

```html
<img
  src="https://stately.ai/registry/machines/1b050e43-c8a5-4e28-b881-71eadcc5b8a1.dark.png"
  alt="State machine for the copy image URL flow in dark mode."
/>
```