Living Lists

How do I use a shared Mix or List?

  1. Search for your library under "Select Library"

  2. Click the blue toggle button to select your library

The blue toggle button turns green when selected

To save your library selection, click the lock and bookmark the page.

Now you're ready to select your list or mix:

  1. Search for a particular List or Mix, or scroll to find the List or Mix you want to use.

  2. Click the blue toggle button to select your List or Mix

Selecting the Treating Opioid Addiction Mix

Now click "View Collection" at the bottom of the page to preview your List or Mix. In this example, we'll preview the Treating Opioid Addiction Mix at Dallas Public Library.

The View Collection button
Preview the Treating Opioid Addiction Mix at Dallas Public Library

Use the Carousel, Grid, and List buttons in the top right corner to preview the different embed formats. Once you have chosen your format, click the Embed List button. The code for your embed will pop up over the page.

Embed Code for the Treating Opioid Addiction Mix at Dallas Public Library

Copy the code to your clipboard, and then paste the code into any website editor. You can also share this code with community partners so they can embed it on their websites.

How do I create my own custom mix?

First, decide what subject(s) you want your mix to include. We will use vaccinations as an example.

Gather the resource IDs for each Topic or Concept. The resource ID is the unique set of numbers and letters at the end of each link. Here is the Concept of vaccinations at Spokane Public Library:

The resource ID for this Concept is: Y8Hh3Kr4qhc

To create your custom mix, gather a list of the Concepts or Topics that you want to display. You can collect these in a CSV or Excel spreadsheet and then copy and paste them into a JSON file. Or you can just start using a text editor to create your Mix JSON file (see creating and saving a JSON file below).

Here's the easiest way to find the Concepts you want to include:

  1. From any data page, go to the Navigate under the Services menu in the top left corner.

  2. Deselect the Items and Person filters so you're only looking for Concepts. Then find the various Bibframe resources you would like to include in your Mix. The options are limitless!

A search for Vaccination Concepts at Spokane Public Library

How do I create a JSON file?

There are many different ways to create a file for a custom mix or list. Your technical comfort will determine what works best for you. This is just one simple way to get started if you have little experience with this type of work.

  1. Start with a pre existing mix or list that you can update. You can get this structure from any preview of a current list from your library. We'll start with the example on Opioids at Spokane Public Library (See Example 1 below).

  2. Remember you are creating a INTERNAL PREVIEW for your partner and the library. Only the resources will actually be viewed on the partners website. If you would like to share your Mix with the rest of the Library.Link Network, please send it to [email protected]

  3. This is the location where the code to be embedded will be made available to you. You will not be limited to a carousel, the code for both a Grid or List will be options you can select.

  1. From here you will want to change the Label, Description, and swap in your list of resources created from Step 1 (see below LINK)

    1. Label - If you share this on Collection.Library.Link - the label lets others know the Topic of your list.

    2. Description - Share the description of the preview

    3. Resources - a list of all the resources you have decided to include in your Custom Mix.

  2. Next you will want to save the file web as a JSON file.

  3. From here you can use the following URL pattern and replace it with the new filename, and update the library with the appropriate Link Domain to be represented.

  4. You can create this file and save this file using GitHub (see below LINK)

How to find an example Mix JSON file:

Treating Opioid Addiction Mix at Spokane Public Library

Click on the highlighted Mix to display the JSON file structure you will need to create your own Mix.

This is what a JSON file looks like:

Treating Opioid Addiction Mix JSON

{ "label": "Treating Opioid Addiction", "description": "Treatment varies but may include discontinuing the drug. Medications such as methadone can help alleviate the symptoms of withdrawal and cravings. Pairing medication with inpatient or support programs generally has the most success.", "resources": [ "z3R9UGngmYM", "FzZxTkEiuiU", "L123acGjWLY", "c3A264A9nk0", "DgzVG7tj8II", "UMttAKNfaIQ", "99GxLOFCEds", "VDXRh-V7S8M" ] }

Here is the Mix with edits made for Vaccination Awareness:

{ "label": "Vaccination Awareness", "description": "Bringing awareness of vaccinations from both sides of the fence.", "resources": "fmIK0cuUY-U", "Y8Hh3Kr4qhc", "O1t9njinLAA", "G8rPUestlAI", "h_7PhNaZ9HA", "7M1Yp1YceL8" ] }

How do I use GitHub to save custom Mixes?

  • Start with a text editor file and use the Mix/List structure provided above

  • If you need help the quickest way is to use, view a current example and click on either a Mix or List and copy the JSON file displayed.

  • Copy and paste the JSON file into your Text Editor workspace

  • Login to

  • Enter the Gist Description

  • Enter in the filename with file extension

  • Copy and paste your code into the text editor

  • Create either a private or public Gist file

Once your file is created, click on the Raw button in the upper right corner.

Will see the raw JSON file and the saved URL that will be needed to create your preview display as well as the code for EMBEDDING onto your web site.

From here you can create the preview and embed code, using your new URL:

You may find it easiest to start with an established URL such as:

And replace the filename (in bold) with the newly created file saved on GitHub:

Put this link into your browser to see your preview of all the mixed Concepts and Topic resources.

In the upper right corner, you can select the format and then click on EMBED to get the code created for any webpage. Many libraries share this code with community partners to increase engagement.

Once you decide on the format that will work best for you, click on the EMBED tab and you will be able to provide the iframe code to be placed onto your website.

From there, anytime a person pulls up the webpage for one of these displays of library resources, we will track this within your link domain stats under Library.Link Applications. (link to STATS FAQ). The library can monitor checkouts for these items internally or use Google Analytics to gather more stats locally.

Can I How often are the NYT Bestseller Lists updated?

We update our NYT list enrichments every Wednesday. Please note that not all NYT lists are updated on their end at this time. In fact, some of NYT lists have an update cadence of every quarter. The "Last Modified" date you see published with your list is the last publish date that NYT claims the list was updated. We've observed that the NYT API is ahead of the web site in terms of best seller information, so if you see a Last Modified date that is before the date of the list on the NYT web site, that is because we get our updates directly from the API.