Images help visitors quickly understand your brand, products, work, and space. However, they are also the easiest way to make a website look unprofessional: files that are too large will fail to upload, those that are too small will appear blurry, and images without descriptions will be unintelligible to search engines and assistive tools.
Kanorio website images are uploaded and used directly when editing modules. There is currently no central "Media Library" to store assets beforehand. In other words, decide which module you want to place the image in, then upload or select the asset from that specific field.
Image fields appear based on the module. For example, hero sections, image-text pairs, galleries, product displays, site logos, favicons, and social sharing images all have their own dedicated image pickers.
Click on the module in the editor preview, or select it from the "Layout" list. Once you find the image field, click to upload, select, or change the image. If you don't have a suitable content block yet, you can add one from "Sections".
Image pickers typically offer three sources: "Upload," "Image URL," and "Stock Library." You can select files from your computer, paste a publicly accessible image URL, or choose from Pexels or Pixabay. After selecting, wait for it to load and confirm the preview is correct.
If you see a cropping tool, adjust the visible area before finishing. Do not leave the settings panel until cropping is complete. When using external image URLs, ensure you have the right to use them and that the source site allows public loading. If the source removes the image, changes the URL, or restricts access, your website may fail to display it.
For fields that support ALT text, please provide a description next to the image. ALT text is not a long-form copy for general visitors, but a short, specific explanation of the image content.
General website images support JPG, JPEG, PNG, and WebP. The maximum file size is 10 MB per file. Files exceeding this size, empty files, or unrecognized formats will be rejected.
General website images do not count toward the media storage quota used for PDFs, audio, and video files. However, this does not waive the 10 MB limit or format restrictions. If you need to upload or manage PDFs, audio, video, or digital product files, please read Managing Website Storage.
| Format | Best For |
|---|---|
| JPG / JPEG | Photos, venue shots, portraits, and images with rich color gradients. |
| PNG | Logos, icons, or designs requiring a transparent background. |
| WebP | Web-friendly images that are typically smaller in file size. |
| HEIC / HEIF | Common iPhone format; will be converted to a compatible image in the browser before uploading. |
HEIC or HEIF are not stored directly on the server. Kanorio converts them in your browser before processing them as compatible uploads. If conversion fails, please export them as JPG on your device and try again.
There is also a rate limit on uploads to prevent abuse. The current protection limit is 20 uploads per minute. If you are temporarily restricted, please wait one minute and try again; avoid clicking repeatedly.
ALT text (alternative text) is a description of an image. It provides a fallback when an image fails to load, and it helps visitors using screen readers understand the content. Search engines like Google also use it to better understand your images.
Good ALT text describes "what is visible" rather than stuffing keywords.
| Poor Practice | Better Practice |
|---|---|
| Coffee, Taipei coffee, coffee shop | Hand-drip coffee and light-roast beans on the bar at a Taipei coffee studio |
| Image | A deep brown handmade tote bag displayed at a leather studio |
| Our best service | A consultant explaining brand strategy to two founders at a meeting table |
Decorative images may not need detailed ALT text, but products, work, portraits, venues, processes, and important infographics should be clearly described.
When you publish or update your site, the system automatically fills in descriptions for compatible images that are missing ALT text. This feature is always enabled and requires no settings. The system derives descriptions based on module text and page content and will not overwrite text you have manually entered.
While this provides basic assistance, we recommend manually reviewing and rewriting ALT text for important images, as the system cannot know which specific details you want visitors to focus on.
The image picker provides two free stock libraries: Pexels and Pixabay. When you aren't ready with your own images, you can search by keyword and select suitable photos to add to your modules.
According to the current terms of the Pexels License and Pixabay Content License, content from both libraries can be used for free on personal and commercial websites, and can be cropped or modified as needed. You do not need to pay extra, nor are you required to credit the photographer or the library on your site.
Kanorio displays the image source and photographer information in the picker to help you recognize the creators; crediting them is still a welcome practice.
These licenses are not "unrestricted for any use." Do not sell or redistribute stock photos as standalone assets, and do not use the images themselves as trademarks, brand logos, or other identifiers.
When using stock photos, choose images that truly represent your content. If you have real photos of your restaurant, storefront, products, team, or work, prioritize using your own assets, as they build more trust than generic stock photos.
Stock photos may contain recognizable people, trademarks, brands, buildings, or artworks. When using images for core brand visuals, advertisements, main product images, or other sensitive contexts, please verify if you need consent for models, trademarks, portraits, property, or other third-party rights. Neither Kanorio nor the stock library terms can replace your own judgment regarding specific usage rights.
Kanorio uses Cloudflare Images to store and deliver general website images, allowing your site to fetch the most appropriate version for the context. You should still choose clear, well-composed images from the source, as the system cannot turn a blurry photo into a professional-grade image.
Follow these principles before uploading:
When someone shares your page on Facebook, LinkedIn, X, etc., they see a social preview. This is called an OG image (Open Graph image), and it is not a general module image.
Manage the sharing image for each page in the SEO settings under "Pages". If no image is manually uploaded and the auto-sharing feature is enabled, the system generates a preview based on the page title and brand settings. To learn more about SEO, read "Complete SEO Settings."
This guide focuses on general website images. To display YouTube, TikTok, Spotify, Apple Music, Podcasts, forms, or booking tools, please use the corresponding integration modules instead of uploading video files as images.
coffee-studio-bar.jpg, to make local asset management easier.The maximum size for a single image is 10 MB. Please resize it or use photo tools to export a web-friendly JPG, PNG, or WebP file before re-uploading. Do not repeatedly upload the same massive file.
It may be due to low original resolution, the image being scaled beyond its original size, or cropping leaving only a small area. Use a clearer original image and check the crop area in the preview.
Yes. The "Image URL" tab in the picker allows you to paste publicly accessible URLs, though the system will warn you about the risks of external images. Only use sources you have the right to use; do not paste URLs that require login, expire, or disallow external loading. If the image is a key asset, we recommend uploading your own file to avoid broken links or removal by the source site.
Check that the file is under 10 MB, the format is correct, your internet connection is stable, and you aren't uploading too many files in a short time. If it still fails, try converting to JPG or WebP and record the error message for support assistance.
Important content images should have it. Purely decorative images don't need long descriptions, but don't leave products, work, service processes, or images containing important text without an explanation.
Yes. According to their current terms, content can be used for free on commercial websites, and crediting is usually not required. However, recognizable content like people, trademarks, brands, or buildings may have additional restrictions; verify before important commercial use.
Kanorio attempts to convert HEIC or HEIF in the browser. If your device or the image cannot be converted, please export it as a JPG on your phone or computer before re-uploading.