From IndieWeb
Jump to: navigation, search

A multi-photo is like a photo post, except just with multiple adjacent photos, either in a series, or tiled / arranged in some layout.

Not a multi-photo post:

  • photos interspersed with narrative text, use an article instead.
  • one ore more photos with one or more videos, use a collection post
  • multiple photos paired with their own captions (person-tags, etc.), use a collection post
  • someone else’s photos, use a repost instead, or at least wrap it in an h-cite.

See Instead use for more on posts similar to multi-photo posts.



Sometimes you might have several photos that seems like part of the same thing, and thus make sense when published all together, with a single description/caption.

Instead use

There are many posts that have multiple photos or other images in them, despite that, they are not necessarily "multi-photo" posts, they are often something else.


If your photos are interspersed with text, especially narrative text, you're writing an article that happens to contain photos. Your post as a whole is not just a "multi-photo" post.



If your photos are specifically delimited by their own captions (or person-tags), e.g. photo1, caption1, photo2, caption2, etc. then you're essentially posting a collection of entire photo posts, since each photo(n) + caption(n) pairing is its own photo post.

  • Use collection instead. Post each photo(n) + caption(n) as its own singular photo post at its own permalink, and include them all in a single collection post.

If your one or more photos are in a set with one or more videos, then you need to use a collection to distinguish separate photos vs poster images for the videos.

  • Use collection instead. Post each photo or video (with optional poster-image photo) as its own singular post at its own permalink, and include them all in a single collection post.

repost or cite

Especially for the above two cases, if you're posting photos which are not yours you should either

  • Use repost to repost the permalink where the author of the photo published it themselves.
  • OR if the author has no original, then cite (using h-cite) the photo as part of your post.

Otherwise if you just use u-photo directly yourself to embed someone else's photos or artwork, since you're the author of your post you're implying they're your photos, that you photographed them or drew them which is kind of like plagiarism.


Like a photo post, but with multiple "u-photo" images.

IndieWeb Examples

Sorted by earliest multi-photo posts first.

Kyle Mahan

Kyle Mahan has been posting multi-photos since 2014-06-29.

Kartik Prabhu

Kartik Prabhu uses Bundle to publish multi-photo posts since 2014-07-28. He does the following:

  1. Uploads the photo(s) to G+ albums purely for storage
  2. Publishes a photo(s) post on his own site
  3. (Semi-)automatically POSSEs to Twitter as a photo post via Bridgy, since 2014-08-30
  4. Manually POSSEs to G+.


Ryan Barrett

Ryan Barrett uses WordPress on to post multi-photo posts since 2004-11-14. Other examples:


Tantek Çelik uses Falcon to publish multi-photo posts since 2015-352 which are note posts with embedded images at the start. He does the following:

  1. Uses Instagram iOS client to post a multi-photo there
  2. Writes & posts a note on his own site that starts with a direct .jpg URL of the photo image, then a space/linebreak, then permalink of the Instagram post (auto-generated using the Instagram Bookmarklet), then at least one more .jpg URL + permalink, then caption.
  3. That "note" is auto-upgraded by CASSIS's auto_link function into a multi-photo post by putting the u-photo class name on the auto-embed <img> of the JPG, since it's the first URL in the "note", and auto-linking it with the subsequent URL, then including any immediately subsequent JPG+URL pairs into additional u-photo embeds.
  4. Falcon automatically uses Bridgy Publish to POSSE the multi-photo as a photo post to both Twitter (first 4 photos per their limit) and Facebook (only the first photo per limit), saving the resulting syndication URLs in storage.


Malcolm Blaney

Malcolm Blaney uses dobrado and SimplePie on to display multi-photo posts with a light box effect. The first photo found in the post is displayed, followed by a description containing the number of photos. Clicking on the photo brings up a light box and navigation options to view the rest of the photos.

Aaron Parecki

Aaron Parecki uses p3k to publish and POSSE multi-photo posts since 2016-08-06.

  • If the post has two photos, they are both 50% of the width of the post and a fixed height.
  • If the post has three photos, they are 33% of the width of the post, and a fixed height, smaller than the 2-photo post.
  • If the post has four or more photos, they are 50% of the width of the post, and a fixed height, slightly smaller than the 2-photo but larger than the 3-photo.
  • The photos are always cropped to a fixed size. Clicking on a photo opens up the photo in a lightbox. (If JS is disabled, this is just a regular link to the full res photo)


This post from 2009 was intended to be a "multi-photo" post, and was posted to Twitter, with three links to Tumblr posts.

Supporting Services Projects

(stub section, please expand with subheads and details (limitations) per project)

The following services and projects support publishing multi-photos:

Silo Examples


Instagram added support for posting multiple (up to 10) square-cropped photos and videos in a single post as of 2017-02-22, and as of 2017-03-10 (at least), allows person-tagging per photo in the multi-photo.


  • items must be square
  • no photo editing (e.g. rotation, trapezoidal adjustments) - filters only
  • as of at least 2017-09-03 it is possible to adjust and edit the individual photos while posting

Launched with limitation (but no longer a problem)

  • no person-tags

Implementation details

The description below may be historical only. as of 2017-03-10 (probably earlier), at least on web, the individual photo permalinks now redirect to the multi-photo permalink.

Each photo or video in an instagram multi-photo has its own shortcode hidden in the Instagram#Unofficial embedded JSON. You can use them to get permalinks for the individual photos and videos, where you can comment and like them separate from the multi-photo, both on web and in the app.

These individual photo/video pages aren't accessible through the web or app UI otherwise, so they seem to be an unintended implementation detail on Instagram's part. However, once you've liked an individual photo/video in a multi-photo, you can get to it in the app via "Posts you've liked."

For example, looking at the announcement multi-photo, the first individual video and photo are and , respectively.

Granary extracts and exposes these individual permalinks. For example, click the individual large pictures in this converted microformats2 HTML:

Here's the corresponding mf2 JSON:


Before this feature, Instagram users frequently posted collage images of multiple photos, often enough that Instagram even built their own separate app, ”Layout”, to help with the creation of these collage images (which are multi-photo posts arranged into a square or rectangle). Example:


Twitter added support for posting multiple (up to 4) photos in a single tweet (when? 2016? 2015?)


Swarm sort of supports multi-photo posts as a secondary aspect of their checkin posts with up to 7 photos!

See: checkin#Swarm for more details (since that's the primary post type supported by Swarm).

See Also

Personal tools
Recent & Upcoming