Showing work on your website
Link to a shared collection, download images, or use the API
If you have your own website, there are a few ways to show works from your vault on it. Valise isn’t a website builder, and it doesn’t connect directly to tools like Squarespace, Wix, or Cargo.
| Option | Updates automatically | Needs a developer |
|---|---|---|
| Linking to a shared collection | Yes | No |
| Downloading images and details | No | No |
| Using the API | Yes | Yes |
Linking to a shared collection
The simplest option is to share a collection and link to it from your site. For example, you could put your available works in a collection and add an “Available works” link to your site’s menu.
Visitors see each work’s image and details. You can also show the retail price and availability by turning on those fields in the sharing options. When you add, remove, or reorder works in the collection, the page updates automatically.
The shared page uses Valise’s design, and can’t be styled to match your site. For privacy reasons, shared collections aren’t indexed by search engines.
Leave the share link’s expiry set to Never. If it expires or is revoked, the link on your site will stop working.
Downloading images and details
If you add works to your site by hand, you can download what you need from Valise.
To download images, open a collection and choose Download images from the … menu. This downloads all images for every artwork in the collection at their original quality.
For titles, years, mediums, and dimensions, choose Export to CSV from the same menu. You can open the file in a spreadsheet app and copy what you need from it.
Your site won’t update when your vault changes. You’ll need to edit it yourself when a work sells or its details change.
Using the API
If your site is custom-built, a developer can use the Valise API to load artworks, collections, and their images directly from your vault, so your site can stay up to date.
To get started, create an API key and share it with your developer. A read-only key is enough for showing works on a site.
If your site is built with Astro, a Valise user has made astro-loader-valise for loading collections and artworks.
Limitations
- Valise doesn’t have a shop or checkout. If a work sells through your site, you can record the sale in Valise afterwards.
- Shared collections can’t be embedded inside a page on your site. They always open as their own page.
If you’d like to see either of these, let us know.