The Media Library
Your Media Library holds every image you upload to BetterSTR. Images in it can be used in your guide content, as a property’s Home Image, in folios, upsell products and Android TV screensavers. Open it from Media Library in the left menu.

The cards across the top show how many images you have, the space they use, how many are large enough to optimise, and how many were added in the last 30 days.
Uploading Images
From the Media Library
- Go to Media Library in the left menu
- Click the Click or drag images here to upload area (1), or the Upload button at the top right, and pick one or more images. You can also drag files straight onto the upload area.
- Each file uploads on its own with its own progress bar. If one fails (too big, wrong type) you’ll see why next to that file and can Retry it; the others still go through.
From the guide editor
The image window in the guide editor has an Upload New tab, so you can add new images without leaving the editor. See Inserting images in guides below.
From the Home Image picker
The Select Home Image window (see below) also has an Upload tab. Anything you upload there is added to your Media Library too.
Supported File Types and Limits
| Format | Best For |
|---|---|
| JPEG / JPG | Photos, property images |
| PNG | Logos, graphics with transparency |
| GIF | Simple animations (the animation is kept) |
| WebP | Modern format with better compression |
- Maximum file size: 5 MB per image
- Maximum resolution: 60 megapixels. Anything larger is refused; resize it first.
- Other file types (HEIC, PDF, SVG and so on) aren’t accepted. The type is checked from the file itself, not its name.
Automatic Image Processing
Every upload is prepared for the web automatically:
- Resizing – Landscape images are scaled down to 1200px wide (1800px if the original is wider than that, so TV screensavers stay sharp). Portrait images are scaled down to 800px tall. Smaller images are left at their size.
- Compression – Photos are re-saved at a web-friendly quality, so files get smaller without visible quality loss.
- Orientation correction – Phone photos that would show sideways are turned the right way up.
- Privacy – Camera details and GPS location are stripped from the file.
Your image keeps its format (a JPEG stays a JPEG). To turn a large image into a smaller WebP, use Optimize (below).
You don’t need to resize images before uploading – we handle it automatically!
Finding and Managing Your Images
Search, filter and sort
The Filters panel (2) on the left lets you:
- Search file names
- Show All images, only Large (over 200 KB) images, or images Added in 30 days
- Sort by Newest, Name or Largest
Image actions
Each image card shows the file name, its size and the date it was added, with buttons underneath:

- (1) Copy link – copies the image’s web address so you can paste it anywhere.
- (2) Optimize – only shown on images over 200 KB (their size is shown in orange). It compresses the image and converts it to WebP so guides load faster.
- (3) Rotate left / Rotate right – turns the image 90°.
- (4) Delete – see Deleting images.
Click an image to preview it full size. The preview shows the file name, size and date added, with Copy link and Open buttons.
Inserting Images in Guides
- Open a content section in the guide editor and place your cursor where you want the image
- Click the image button in the toolbar (1), next to {{shortcode}}, or choose Insert → Image... (2)

- The Media Manager opens with three tabs:
- (1) Browse Media – your Media Library
- (2) Upload New – drag in or select images (JPEG, PNG, GIF or WebP, up to 5 MB each) and click Upload Images. When it finishes you’re taken back to Browse Media.
- (3) Free Images – stock photos every host can use
- Click an image to insert it. It’s added full width (up to 600px) and scales down on phones.
- Click Save Changes to save the section.

Don’t drag or paste images into the text
Images dragged or pasted straight into the editor can’t be saved, so they’re swapped for a yellow Image cannot be saved box. Click that box (or the image button) and add the image through the Media Manager instead.
Setting a Property’s Home Image
The Home Image is the main picture guests see at the top of the guide.
- Go to Properties, open the property and click Property Settings
- Pick Home Image in the On this page list and click Change Home Image
- In Select Home Image, choose from Property images (your listing photos from your PMS, plus Slideshow and Blur first image, when the property has photos), Browse media, Upload or Free images
- Click Select image, then Save Changes

If you don’t pick one, the guide uses your Property Defaults setting, or a blurred copy of the first listing photo.
Image Best Practices
Photo Tips
- Show, don't tell – A photo of the lockbox is better than describing its location
- Use good lighting – Bright, clear photos are easier to understand
- Include context – Show surrounding landmarks to help guests find things
- Update seasonally – Winter photos in summer can confuse guests
Recommended Image Uses
- Property exterior (helps guests find it)
- Lockbox or key safe location
- Parking spot or garage access
- Appliance controls (thermostat, TV remote)
- Rubbish bin locations
- WiFi router/password sticker
- Local landmarks for directions
Deleting Images
- Go to Media Library in the left menu
- Find the image you want to delete
- Click the red trash button on its card
- Confirm the deletion
Note: Deleting removes the image file for good and it can’t be undone. It disappears from every guide, Home Image, product or screensaver that uses it, so check it’s not in use first.
Free Stock Images
Need a quick picture? BetterSTR has a set of free stock images (cleaning, WiFi, EV charger, breakfast, late checkout, firewood, hot tubs, bike hire and more) that every host can use:
- Open the image window: the image button in the guide editor, or Change Home Image in Property Settings
- Click the Free Images tab
- Click an image to use it
Free images are used directly from our shared collection. They aren’t copied into your Media Library.