K
Docs
API Reference→Pieces→Pull from Gallery
🖼️

Pull from Gallery

img.galleryThe DarkroomImages

Fetches an image from this bot's Gallery tab — by its label, or by tag (a random one, the newest, the oldest, or all of them). Upload new images any time; flows see them instantly, no republish needed.

When to use this
  • →Any image field also takes gallery:your-label directly — no piece needed
  • →Pair with buttons and Update the Message to page through a tag

On the canvas

This is what Pull from Gallery looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

🖼️
Pull from Gallery
img.gallery
Images
mode
select…
label
welcome-banner
tag
memes
pick
select…
as
image
found
empty

Config fields

FieldTypeReqWhat it does
modeselect—Find it by 🔎
label
welcome-banner
gallery—Label 🏷️
tag
memes
text—Tag #️⃣
pickselect—Which one 🎲
as
image
text—Save it as ✨

Output ports

foundGot the image(s)
emptyNo image has that label or tag
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
// Your Gallery lives in object storage; rows remember label + tags
const pick = gallery.filter((img) => img.tags.includes("memes"));
const meme = pick[Math.floor(Math.random() * pick.length)];
const image = await loadImage(meme.url);