Application Logos
Overview
AppsFolio supports two methods for adding logos to your applications:
- External URLs - Link to an image hosted elsewhere on the internet
- Uploaded Files - Upload and store image files directly in AppsFolio
Uploaded logos are securely stored in cloud storage (Cloudflare R2) and served through AppsFolio with proper access controls.
Logo Types
External URL Logos
URL-based logos reference images hosted on external servers. This is useful when:
- Your organization already hosts application logos on a CDN or asset server
- You want to use logos from the application vendor's website
- You prefer to manage image hosting separately
Simply provide the full URL to the image (e.g., https://example.com/logos/slack.png).
Uploaded File Logos
File-based logos are uploaded directly to AppsFolio and stored securely. This is useful when:
- You don't have external hosting for your logos
- You want all assets managed in one place
- You need to ensure logos remain available even if external sources change
Uploaded logos are served through secure, time-limited signed URLs for privacy.
Supported File Formats
When uploading logos, the following image formats are supported:
| Format | Extension | Notes |
|---|---|---|
| PNG | .png |
Recommended for logos with transparency |
| JPEG | .jpg, .jpeg |
Good for photographic images |
| GIF | .gif |
Supports animation |
| SVG | .svg |
Vector format, scales perfectly |
| WebP | .webp |
Modern format with good compression |
File Size Limit: Maximum 5MB per logo file.
Logo Scopes
Logos in AppsFolio have two possible scopes:
Tenant-Specific Logos
- Visible only to users in your organization
- Can be uploaded by Org Admins and App Managers
- Stored separately for each tenant
- Used for your organization's private application logos
Common (Resource Library) Logos
- Available to all AppsFolio users across all organizations
- Can only be managed by AppsFolio administrators (superusers)
- Used for well-known applications in the Resource Library
- Shared across all tenants
How to Add a Logo to an Application
When Creating an Application
- Navigate to Applications and click Add App
- Fill in the application details
- In the Icon field, you can:
- Enter an external URL to an image
- Or use the logo upload feature to upload a file
When Editing an Application
- Open the application you want to edit
- Click Edit to enter edit mode
- Update the logo using either:
- An external URL in the Icon field
- The logo upload feature for file uploads
- Save your changes
Managing Uploaded Logos
Viewing Your Logo Library
Access your organization's uploaded logos at /app/logos/library/. This shows:
- All logos uploaded by your organization (tenant-specific)
- Common logos from the Resource Library
Deleting Logos
To delete an uploaded logo:
- Org Admins can delete any tenant-specific logo
- Common logos can only be deleted by AppsFolio administrators
Warning
Deleting a logo will affect all applications using that logo. The applications will display without a logo until a new one is assigned.
Access Control
Logo access is controlled based on scope and user permissions:
| Action | Tenant Logos | Common Logos |
|---|---|---|
| View | Users in the tenant | All users |
| Upload | Org Admins, App Managers | Superusers only |
| Delete | Org Admins | Superusers only |
Technical Details
Storage
- Uploaded logos are stored in Cloudflare R2 (S3-compatible object storage)
- Each tenant's logos are stored in a separate namespace
- Logos are served via signed URLs that expire after 2 hours for security
URL Structure
- Uploaded logos are served from:
/app/logos/{logo-id}/ - This URL redirects to a secure, time-limited signed URL
- External URL logos redirect directly to the external source
Best Practices
-
Use PNG or SVG for logos - These formats support transparency and look crisp at any size
-
Keep file sizes reasonable - While up to 5MB is allowed, smaller files (under 500KB) load faster
-
Use square or near-square images - Logos display best when they have similar width and height
-
Consistent naming - Give logos descriptive names so they're easy to find in the library
-
Consider using external URLs for vendor logos - Many software vendors provide official logo assets that are kept up to date
Troubleshooting
Logo not displaying
- Check the URL - For external URLs, verify the link is accessible and the image loads in a browser
- File format - Ensure the file is one of the supported formats
- File size - Confirm the file is under 5MB
- Permissions - Verify you have access to view logos in that scope
Upload failed
- Check file size - Files over 5MB will be rejected
- Check file type - Only supported image formats are allowed
- Try again - Temporary network issues can cause upload failures