Page tree
Skip to end of metadata
Go to start of metadata

To build a collection, begin in the "Collection" tab of the Collection Manager. Click on the "New Collection" button and start creating the properties for that collection. You can easily edit these collection properties any time, even if a collection is already published and displaying in the LUNA Viewer.

Watch the Video:

Collection Properties:

Collection Identity

  • Collection Name: Give your collection a name, you may use up to 200 characters including spaces.
  • Collection Owner: The name of the user that created the collection will be displayed here once a new collection has been created. Only a Super Admin can pass ownership of a collection to a different user so that they have Item Level Restriction privileges by typing in the username and clicking the Save button. This should be followed by a Rebuild of the Viewer Index. Note, there can only be one collection owner per collection.
  • Collection Description: The description appears in the LUNA Viewer on the collection selection page.

  • Data Schema: This is a very important part of your collection building process. Each record in a collection will be based on the structure of the data schema you select. Every data schema is based on a data template. Use the pull down menu to select an existing data template. If you're just starting out and there are no templates to select from, go to the Templates tab and create one. After you save the collection properties you cannot change which schema is being used.

    If you'd like to change or edit your data schema later on, click on "View/Edit schema" and edit the schema. Edits to a schema will not be made to the actual template you've selected; you're just making changes to a version that is attached to the collection.

  • Header Graphic: Upload a custom header graphic to better brand your collection. This will appear in the LUNA Viewer. If you prefer, you can enter a URL that points to the graphic instead. Note: Make sure the file name for the graphic has no special characters or spaces. For example, mylunaheader.jpg will work but my(luna) header.jpg will not work. 
  • Uploading Header Graphic: To upload a header graphic to the LUNA system, click on the Upload or select header graphic button. Next click on Select file and locate the file you want to use as your header graphic. Then click on the button with the up arrow to upload the graphic. To add a header graphic to a collection, select the header graphic you want to use and done.

Recommendations for LUNA Header Graphic:

    • Max height: 60px
    • Max width:  530px
    • Background should be transparent (.png file)
    • The logo or text should be centered vertically allowing a little space on the top and bottom, and with about 20px of space on the left.


Download the Photoshop PSD file Library Museum Logo.psd

  • Default Group ID (v7.1.6+): Display media from a particular Media Group on the Collection Selection page in the LUNA Viewer. To locate the Media Group ID, go to the Viewer and open the desired Media Group to feature. At the top of your browser, look for the number at the end of the URL string (in this example it's 2). Type that number into the Default Group ID and "Save".
    • LUNA Viewer Theme:  Additional themes will be available in the future.

Viewer Field Settings

  • Title: The Title selection will show up in a number of places. It shows up as the page title of the detail view and other prominent locations.
  • Default Date Field: Used for the simple search Date Range searching.
  • Thumbnail Fields: Select which of the 4 fields you'd like to have display in the LUNA Viewer for your thumbnail fields. These fields are coming from the data schema you previously selected.

  • Related Item Field (v7.1.6+): Select a field to represent related items in a collection within the LUNA Viewer. Related items will display in the Viewer when there are two or more identical terms in the field you select. For an existing collection, a Rebuild LUNA Viewer Index is required. See  Related Items in the Viewer for an example.

    • Sort Fields: Select which of the 4 fields you'd like to sort your collection by in the LUNA Viewer. These fields are coming from the data schema you previously selected.

  • Summary Fields: Select which of the 4 fields you'd like to have display as the roll over media summary in the LUNA Viewer. These fields are coming from the data schema you previously selected.

Who, What, Where, When Facets

  • Category Fields- Who, What, When, Where: Drag and drop up to 20 fields into the Who, What, When, Where categories. These will be represented in the LUNA Viewer in the "Explore Categories" view, in the Advanced Search when searching across multiple collections, and in the narrow search feature.

    (v7.2.5.0+) Additionally, if you have enabled Image Analysis (below), you can choose to map "Labels" to the What category and "Landmarks" to the Where category.

    The Rebuild LUNA Viewer Index button should only be applied if changes are made to the settings for Who, What, When, Where category fields. Or, if you notice a discrepancy between the data in the LUNA Library and what's appearing in the LUNA Viewer. We recommend doing this during off peak hours

Custom Single Field Facets

  • Custom Single Field Facets (7.5.3+): Allows you to create facet fields that are unique to a collection. You may create as many facets as you wish. See an example in the Viewer.
    • Select the plus icon "+" to start creating a new facet. Type in the custom name you want to give your facet in the first box and then select the corresponding field from your data scheme in the second box.
    • You can select one facet to be the Primary facet in the LUNA Viewer by checking the box. This optional step will only show the Primary item first. Once a user chooses a value, then the non-primary facets will be displayed. Setting a primary facet is recommended for large collections, as a way for admins to create a more precise way for users to find what they might be looking for.
    • Check the "AZ" box if you want the values in the facets sorted alphabetically instead of by count.

The Rebuild LUNA Viewer Index button should only be applied if changes are made to the settings for Custom Single Field Facets.

Advanced Integration Settings


  • Sharing: Allows your public LUNA collections to be shared with other LUNA users, creating a IIIF Activity Stream in the LUNA Viewer. By default the box will be checked. Uncheck the box if you do not want a public collection to be shared.

  • Canonical Address:  Allows you to share your collection with the LUNA Commons. For more information contact Luna support. This will point back to your instance of LUNA in all web crawlers. So any institution sharing your content publicly using the LUNA Commons will be advertising your site and content. This will increase your page rank in search engines like Google. This needs to be the base address of your LUNA site. For example

OAI-PMH Settings

  • OAI-PMH Mapping:   OAI-PMH is a protocol for sharing metadata and allows your collection metadata to be harvested by other repositories. Select a data field from the left hand menu and then select which of the Dublin Core fields you'd like to map it to. For more information contact Luna support.


Relay Button

  • Include Relay Button: The Relay Button can be used as a link from the Detail View to an external destination like a buy button or an in-context comment page. You can enable the Relay Button in the Collection Manager. This will create a button (previously the Buy Button) that appears at the top of LUNA when viewing an image. For more information contact Luna support.

Media Item Metadata Settings

  • Media Metadata Options: Check the boxes that apply to search for and display custom user defined fields, EXIF, IPTC, and XMP info in the LUNA Viewer. 
    Custom Data Fields are user defined fields that act as supplemental descriptive data in a collection and the only data fields available for an item in the Independent Media Items.

    Tip: To ensure your EXIF, IPTC, and XMP data is searchable within LUNA, be sure to check the boxes under the Search heading before uploading your Media Items.

Uploader Settings

  • Uploader Settings: By checking the box you are storing the source image by default every time you upload images in the Uploader. 

Google Cloud Settings

  • Enable Image Analysis (v7.2.5.0): Check this box if you want to enable the Google Cloud Vision API Image Analysis feature when uploading images to your collection. Additionally, if you have enabled Image Analysis (below), you can choose to map "Labels" to the What category and "Landmarks" to the Where category.

  • Enable Google Cloud Storage (v7.3):  Check the box if you want to store source and associated files in Google Cloud Storage. Once you check this box you can select  Nearline or Coldline as well as what files to store in Google (currently source & associated files are the only option). If you do not want to store source and associated files on the LUNA server, make sure to check the box for the option to exclude uploading source and associated files to the LUNA server.  

Rebuild Library Index button is v7.1.2+

The Rebuild Library Index button is only recommended in certain circumstances like when an upgrade requires it or Luna's support department recommends it. If you need to rebuild the Library index, we recommend doing this during off-peak hours.

  • No labels