How to Upload and Manage Images

Add images to your articles to make them more engaging and informative. Learn how to upload, manage, and optimise images in your knowledge base.

Supported Image Formats

Zuro supports the following image formats:

• JPEG (.jpg, .jpeg) - Photos and complex images
• PNG (.png) - Graphics with transparency
• GIF (.gif) - Animated images
• SVG (.svg) - Vector graphics
• WebP (.webp) - Modern web format

Image Requirements

File Size

• Maximum size: 10MB per image
• Larger images are automatically optimised
• Recommended: Keep images under 5MB for faster uploads

Image Dimensions

• No strict limits: Zuro handles various sizes
• Recommended: 1200-2000px wide for best quality
• Mobile-friendly: Images are automatically responsive

Uploading Images

Method 1: Direct Upload in Article Editor

1. Open the article editor
2. Place cursor where you want the image
3. Click the image icon or use ![alt text](url) markdown
4. Click "Upload Image" or drag and drop
5. Select your image file
6. Wait for upload to complete
7. Image appears in your article

Method 2: Using Markdown

1. Upload image to a hosting service (or use Zuro's upload)
2. Use markdown syntax: ![Alt text](image-url.jpg)
3. Add title: ![Alt text](image-url.jpg "Image title")

Method 3: Drag and Drop

1. Open article editor
2. Drag image file into the editor
3. Drop where you want the image
4. Image uploads automatically

Image Best Practices

Alt Text

Always add descriptive alt text:

• Describe the image: What does it show?
• Be specific: "Screenshot of settings page" not "Image"
• Include context: Help screen readers understand
• Keep it concise: 1-2 sentences maximum

Image Placement

• Relevant placement: Put images near related text
• Don't overuse: 1-2 images per section is usually enough
• Break up text: Use images to break long paragraphs
• Support content: Images should enhance, not distract

Image Optimisation

• Compress before upload: Reduce file size when possible
• Use appropriate format: JPEG for photos, PNG for graphics
• Right size: Don't upload 4000px images if 1200px is enough
• Consider WebP: Modern format with better compression

Managing Images

Viewing Uploaded Images

1. Go to your knowledge base settings
2. Find "Media" or "Images" section
3. View all uploaded images
4. See file sizes and dimensions

Reusing Images

• Same image in multiple articles: Upload once, reuse URL
• Copy image URL: Get link from media library
• Reference in markdown: Use the stored URL

Deleting Images

1. Go to media library
2. Find the image to delete
3. Click delete/remove
4. Confirm deletion
5. Note: Removing from library removes from all articles using it

Image Optimisation Tips

Before Upload

• Resize large images: Use image editing software
• Compress files: Reduce file size without losing quality
• Choose right format: JPEG for photos, PNG for graphics
• Remove metadata: Strip EXIF data if not needed

After Upload

• Check display: Verify image looks good in article
• Test on mobile: Ensure images work on small screens
• Verify alt text: Make sure alt text is descriptive
• Check loading speed: Large images may slow page load

Common Use Cases

Screenshots

• How-to guides: Show step-by-step instructions
• Feature explanations: Highlight specific features
• Troubleshooting: Show error messages or issues
• Best practice: Use arrows or annotations to highlight

Diagrams

• Process flows: Show workflows and processes
• Architecture: Display system structures
• Charts: Visualise data and statistics
• Best practice: Keep diagrams simple and clear

Product Images

• Feature showcases: Highlight product features
• Before/after: Show improvements or changes
• Product photos: Display products or services
• Best practice: Use high-quality, well-lit photos

Troubleshooting

Upload Fails

• Check file size (must be under 10MB)
• Verify file format is supported
• Try a different image
• Compress the image and try again

Image Not Displaying

• Check image URL is correct
• Verify image is uploaded successfully
• Check markdown syntax is correct
• Clear browser cache

Image Too Large

• Resize image before uploading
• Use image compression tools
• Consider using a smaller version
• Use WebP format for better compression

Slow Loading

• Compress images before upload
• Use appropriate image sizes
• Consider lazy loading for many images
• Optimise images for web