Skip to main content
Documentation & User Guides | Fotoware

Setting custom background images for use on the FotoWeb login screen

By default Fotoware will download background images for use on the login screen from a Fotoware repository on the internet. If you would rather use your custom collection of background images that comply with your corporate profile, you can do so by changing the setting in the Fotoware site settings.

Note: You cannot use a collection (album or archive) from another site as custom background images.


  1. Go to Tools (cogwheel icon) > Site Configuration > Appearance > Branding.
  2. Open the Corporate Branding tab.
  3. Turn on the Use custom background images for login page toggle and enter the URL to the collection you would like to use.


  1. Select Save.


How to create a custom collection of login page images?

The simplest way to create a collection is to add the images to a Fotoware album. Then create a public link to that album and paste that link in the configuration.

Other possibilities:

  • Use the URL to a public archive (an archive to which the Everyone group has browse access)
  • Publish a static JSON document with links to each asset in the collection and use the URL to this document in the configuration (see below).

Note: The login collection must be from an album available for guest (such as a shared URL), a public archive, or a static folder available on the same domain (for example hosted in IIS).

Creating a static json document at a fixed URL

A static JSON document can be published at a URL that Fotoware can reach. It should be in the form of a Fotoware Collection, as documented in the API guide.

Here’s an example of the minimum information required to define a background image collection:

    "data" : [ {
        "href" : "",
        "previews": [ { 
            "size" : 1920,
            "width" : 1920,
            "height" : 1080,
            "square" : false,
            "href" : "" } ],


Note: When creating a custom JSON document, the server that delivers the files needs the appropriate CORS policies set.