> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinship.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Add Custom Thumbnails

> Learn how to set custom preview images for families and types in Kinship using the website.

## Customizing thumbnails on the website

Follow these steps to set custom preview images for families and types.

> [!NOTE]
>
> This guide assumes you only have one Revit version of the family. For **multi-version content**, you will need to go into the **Revit Versions** page and then go into the Files page within each specific Revit version you want to update.

1. Navigate to a family's detail page.
2. Click on **Files** to reveal the content files.

![Family Files page](https://mintcdn.com/kinship/RzSH_KPQEqM5zp1G/images/custom_thumbnail-1.png?fit=max\&auto=format\&n=RzSH_KPQEqM5zp1G\&q=85\&s=9e57c31155a3fe27297c3a87b5e58cff)

3. Upload an image labelled 'thumb' (for instance, `thumb.png`). This image will replace the previous preview image file, and the new image will be used as the preview image for the family. To use an image for a specific family type, name it using the type name.

![Upload thumbnail image](https://mintcdn.com/kinship/RzSH_KPQEqM5zp1G/images/custom_thumbnail-2.png?fit=max\&auto=format\&n=RzSH_KPQEqM5zp1G\&q=85\&s=b7b979f6485abe50ffb1950de3755e9c)

***

## Known issues

**Issue:** When a family is overwritten, the custom thumbnail will be replaced by a new default automatic thumbnail with no way of preventing the replacement.

**Workaround:** You can restore a previous custom thumbnail from the family's Files page following these steps:

1. In the family's **Files** page, click on the three-dots button in the top right corner and select **Show Deleted Files**.
2. Find the customized thumbnail image that was overwritten and click on **Restore** underneath it. The page will refresh to show the restored image.

***

## Additional information

1. The filename uploaded as `thumb` gets automatically renamed to match the family name. For instance, if you upload a `thumb.png` file to a family named "Socket", it will be renamed to `Socket.png` upon download from the Family Files page.

2. If you upload a custom image with a name other than `thumb`, you can either **Rename** the file to `thumb.png` by clicking on its name in the tile. Alternatively, if you don't need to save the original family png, you can delete it. If there is only one image file for the family or family Revit version, Kinship will always use that image as the thumbnail, regardless of its filename.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.