👁️ Visibility

Panoramax offers a way to control the visibility of the pictures. The visibility makes it possible to host non-public pictures on a public instance.

Visibility can have 3 different values:

• anyone: the pictures can be seen by anyone
• owner-only: the pictures can be seen by the owner and administrator only
• logged-only: the pictures can be seen by anyone logged on the instance

The logged-only visibility is especially useful for instances that want to mix public and private pictures (like pictures of private buildings, private roads that can be used by firefighters...).

The visibility can be set at different levels, using the APIs (or the website):

• At the picture level (using a POST/PATCH query on the /api/collections/:cid/items/:id route)
• At the sequence level, to change the visibility of all pictures in the sequence (using a POST/PATCH query on the /api/collections/:cid/items/:id route)
• At the upload set level, to change the visibility of all pictures in the upload set (using a POST/PATCH query on the /api/upload_sets/:id route)

A default_visibility can also be set at the account level (using the PATCH query on the /api/users/me route).

And a default visibility for the whole instance can be configured, either with the API_DEFAULT_PICTURE_VISIBILITY environment variable or by updating the default_visibility in the configurations table of the database.

If no default visibility is set, the default is anyone.