Facebook Tracking Pixel
Guestbook

Uploading and Managing Images

Learn how to upload, organize, and optimize images for your digital guidebooks using the BetterSTR media library.

Updated 5 min read

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 Media Library: (1) click or drag images onto the upload area, (2) search, filter and sort your images

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

  1. Go to Media Library in the left menu
  2. 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.
  3. 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:

Buttons on an image card: (1) copy link, (2) optimize, (3) rotate left and right, (4) delete

  • (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

  1. Open a content section in the guide editor and place your cursor where you want the image
  2. Click the image button in the toolbar (1), next to {{shortcode}}, or choose Insert → Image... (2)

Guide editor toolbar: (1) the image button, (2) the Insert menu

  1. 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
  2. Click an image to insert it. It’s added full width (up to 600px) and scales down on phones.
  3. Click Save Changes to save the section.

The Media Manager in the guide editor: (1) Browse Media, (2) Upload New, (3) Free Images

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.

  1. Go to Properties, open the property and click Property Settings
  2. Pick Home Image in the On this page list and click Change Home Image
  3. 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
  4. Click Select image, then Save Changes

The Select Home Image window, showing the Free images tab

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

  1. Go to Media Library in the left menu
  2. Find the image you want to delete
  3. Click the red trash button on its card
  4. 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:

  1. Open the image window: the image button in the guide editor, or Change Home Image in Property Settings
  2. Click the Free Images tab
  3. Click an image to use it

Free images are used directly from our shared collection. They aren’t copied into your Media Library.

Related articles

More in Guestbook

All Guestbook articles →

Still need a hand?

Book a free 1-on-1 video call and we will go through it with you on screen, or send us a message.

Contact support