|
| 1 | +--- |
| 2 | +Title: Lists |
| 3 | +Date: 2025-05-26 |
| 4 | +Order: 5 |
| 5 | +--- |
| 6 | + |
| 7 | +Lists in Bookwyrm are a way to organise and display similar books together. |
| 8 | + |
| 9 | +The Lists page is accessible from the 'Lists' tab on the main page. |
| 10 | +To see your Lists, click 'Your Lists' below the title or navigate to your profile to the Lists tab. |
| 11 | + |
| 12 | +## Creating a List |
| 13 | + |
| 14 | +To create a List, first select the 'Create List' button on the top right of the page. |
| 15 | +It needs a name, and you can optionally add a description. |
| 16 | +You will then choose how you'd like to curate the List. |
| 17 | + |
| 18 | +## List curation |
| 19 | + |
| 20 | +There are four options for List curation: |
| 21 | + |
| 22 | +- **Closed**: Only you can add and remove books to this list. |
| 23 | +- **Curated**: Anyone can suggest books, subject to your approval. |
| 24 | +- **Open**: Anyone can add books to this list. Only you can remove them. |
| 25 | +- **Group**: [Group](/groups.html) members can add to and remove from this list . |
| 26 | + |
| 27 | +## List privacy |
| 28 | + |
| 29 | +Lists have similar privacy levels as other things in Bookwyrm: Public, Unlisted, Followers and Private. |
| 30 | +See more details on the [privacy controls](/privacy-controls.html#lists) page. |
| 31 | + |
| 32 | +## Adding books to a List |
| 33 | + |
| 34 | +You can add books to any List that you own, "Open" Lists and group-curated Lists of Groups you are a part of. |
| 35 | +You can also suggest books to "Curated" Lists in the exact same way. |
| 36 | + |
| 37 | +There is a side menu (at the bottom on mobile) titled "Add books" or "Suggest books". |
| 38 | +It shows books that you've recently interacted with on Bookwyrm, and a search bar. |
| 39 | +Currently, the search is limited to book titles (see issue [#3607](https://github.com/bookwyrm-social/bookwyrm/issues/3607)). |
| 40 | +Once you find the one you want, use the 'Add' button to add it to the List. |
| 41 | + |
| 42 | +### Notes |
| 43 | + |
| 44 | +You can add a "Note" to each book in a List, which could be used to explain why it was added. |
| 45 | +Notes are added when a book is first added, or at any time with the 'Add notes' button. |
| 46 | +They are displayed with the book when the List is viewed. |
| 47 | +To delete a note, edit it, remove everything in it, then press 'Save'. |
| 48 | + |
| 49 | +### List order |
| 50 | + |
| 51 | +The owner or curator of the List can set a custom display order for the books in it. |
| 52 | +By default, new books are added to the end of the List. |
| 53 | +The position of a book can be changed with the 'List position' box below each book. |
| 54 | + |
| 55 | +## Sorting Lists |
| 56 | + |
| 57 | +You can sort by the manually created list order, book title or average rating, in ascending and descending order. |
| 58 | + |
| 59 | +## Lists sidetab on book pages |
| 60 | + |
| 61 | +There is a sidetab on each books page which shows the Lists it is in, if it is in any. |
| 62 | +This is great for finding similar books suggested by the community. |
| 63 | + |
| 64 | +## Saving Lists |
| 65 | + |
| 66 | +Lists can be 'saved' or bookmarked using the button in the top right when viewing it. |
| 67 | +There is a tab on the main Lists page which shows all your saved Lists, allowing you to find it later. |
| 68 | + |
| 69 | +## Embedding Lists on other websites |
| 70 | + |
| 71 | +If you have a blog or personal website, you are able to embed a List from Bookwyrm onto it. |
| 72 | +Find the section 'Embed this list on a website' below sorting and adding books, then copy the embed code. |
| 73 | +This is in the form of an iframe and can be pasted directly into your website. |
| 74 | + |
| 75 | + |
0 commit comments