Quick Start, under 5 mins! 🔗
1. Upload Images
To get started, simply upload your image using the upload button on the top right of your screen. Select the images, click upload to staging and click done. A summery will appear of the completed task and a notification will also be added to confirm the upload is complete.
2. Create a collection
Now that you have images added to your staging environement, we need to add a collection. A collection is where all your processing happens. It's also where you can see a summery of images clicks, click though rate, impressions etc. To add a collection, simply press the add collection button next to the upload button.
3. Add images to your collection
Let's add the recently uploaded images to this collection, so we can process them and get those clicks showing! You'll find an "Add Images" button on the buttom right of the collection. Click this button and a popout will appear. Select the images you can to add to this collection and click add. The collection card will change and show you a preview of the images. Also, the "Add Images" button will change to a "Actions" buttons. You can add more images at any time, however you cannot add images that are already in a collection. Don't worry, if the image is in another collection, it simply won't let you add the image. This is so the image performance data remains collection specific and no data drifts between collections - making these collections accurate and real-time!
4. Process your images
Now that images are in the collection, we need to run them though some processing to extract data from them. You have a few options:
We'll discuss these in detail in another section but for now, all you need to know is selecting these options will tell URLMagic to detect faces, text or whatever options you have selected. These are all saved and can be viewed later.
Click on the "Extract AI Meta Data" button and the processing will start. Once complete a summary will show and a second step, "Create SEO URL's". Click this button and the URL's will auto generate, alt text will be added and the resulting URL will use information generated from the processing step. This is done completely automatically and is designed for best in class SEO, without any configuration.
6. Add the tracking script to your website
Before you add the images to your website, add our tracking script. This is ready to go and can be placed anywhere inside the head tags of your website (whereever the images are placed). You'll find the script inside the settings section. Click on the cog icon on the top right of the screen, next to your name. A side panel will popout from the right, click on "tracking script" drop down and copy the script using the copy button. Add this near the top within the head section of your website and that's done!
7. Add the images to your website
Everything is now good to go; add your images to your website and they will automatically report back to you. To add images to your website, simply navigate back to the collection that holds the images in question, find the image, click on the "actions" button, click on view details, a side pannel will popout, click copy next to URL and Path and paste this into whereever the iamge needs to load. Note, this full path needs to be added, not the direct URL inside the text box. It will look something like this:
Add this to whereever you want the image to load on your website and whenever it's loaded, clicked etc the collection and reports section will show the events, in real time!
That's it, all done! 🪄
All done. The images will report back to you via the collection and the reports section. If you can any feedback or feature requests please join our community Slack Channel and we'll be happy to discuss these as well as any questions. Thanks for choosing URLMagic.
AI Processing, Metadata and SEO URL's 🔗
Here's all the data we can extract from your image:
- Safe Search (always active)
- Colour Palette (always active)
- Auto tag lables, objects and web entities
- Optical character recognition
- Landmarks
- faces
- logos
- Clean
- adult: VERY_UNLIKELY
- violence: VERY_UNLIKELY
- racy: VERY_UNLIKELY
- medical: UNLIKELY
- spoof: VERY_UNLIKELY
- Facial hair 88%
- Beard 86%
- Collage 78%
- Moustache 61%
- Audience 55%
- Celebrating 53%
- Hair coloring 52%
- Makeover 51%
- Flag
- Person
- Clothing
- Face 1 Joy 99%
- Face 2 Neutral 50%
- Face 3 Joy 98%
Here's a breakdown of what this means and what is actually extracted
Safe Search (always active)
This detects if the image is safe from potentially adult content. Example tags generated:
This is useful if you want to detect adult, violent, racy, medical or spoofed content within your images. The information will be shown within the details section of your image.
Lables
Used to detect useful lables with a percentage marker. For exampple, an image processed with faces in mixed backgrounds will return:
This is useful for understanding complex settings within images.
Object Detection
Used to detect specific objects such as "person" or "flag". An image processed with a mix of objects returned:
This is useful for extracting objects from images.
Face Detection
Used to detect faces with a count result. An image processed with a mix of objects and faces returned:
This is useful for extracting facial data.
Reports and Analytics 🔗
URLMagic provides several detailed reports and analytics at 3 levels. 1. The reports page which summarises all reports, 2. at the collection level which is collection specific and 3. at the individual image level. This gives you unparalleled deep insights to your image performance and popularity in real-time!
To access the reports page, simply click the graph icon next to the Add Collection icon on the top right of the screen. This will pop-in a canvas with several totals:
Clicks
Impressions
True impressions
Average click though rate in %
Cache Hit
Higher is better - should always be 100%
Average TTFB
Lower is better - should always be 0
Average Waste (any number above 2 is bad, check image ratio on your site)
Largest Contentful Paint
Total clicks for all images found on the platform
Total loads of the images after the page is loaded
Number of times the image appeared to the end-user and was viewed
Clicks are the raw count of how many times a user interacted with a link or ad. Click-Through Rate (CTR) is a percentage measuring how many of the people who viewed your content actually clicked it
TTFB will show as 0 or near 0 when orperating at full capacity. When 0 is shown it means all images are severed from our cache and being delivered by one of our +335 edge locations. There is no special configuration needed after your image is added to your website - set and forget!
On average, images account for up to (60-75%) of a webpage's total payload. Industry audits and performance testing tools frequently reveal that oversized images result in 1MB to 2MB of unnecessary data waste per page load, directly harming Core Web Vitals like Largest Contentful Paint (LCP). URLMagic detects and displays this here.
LCP stands for Largest Contentful Paint. It is a Core Web Vitals metric that measures the time it takes for the largest image or text block visible in the viewport to fully load. Lower is better - between 200 and 300 is good
Most Popular Image
Shows 10 of the most popular images sorted by clicks and impressions.
Top Region
Shows 10 of the most popular region your images have loaded in.
Devices
Shows most popular device your images have loaded in, mobile or desktop.
Referrer
Shows most popular website domains the images have loaded from.
URLMagic AI 🔗
URLMagic AI is your dedicated assistant for optimizing SEO, PageSpeed Insights (PSI), and platform workflows. Designed with security at its core, our AI operates in an isolated, sandboxed environment with read-only access to your data—ensuring it can never modify or compromise your production assets. Our AI updates every 5 minutes of so and this is done automatically.
To launch the assistant, click the chat icon located at the bottom-right of your screen.
Quick FAQ
- What are my limits?
- Do I need to pay for more chats?
- Security
- Do I need to do anything to get started?
Here's a quick FAQ on our AI
Limits are displayed in the chat and under the send button. All users get 25 days per day with a cool down peroid between chats. Our AI will respond when limits are reached and will clearly display the cool down time.
For our free and starter plans, 25 chats per day are included. Our enterprise plan includes different limits. Higher usage limits are available on Enterprise and API plans. Check your account settings to view your current tier and quotas.
We employ a "secure-by-design" approach. Our AI is hardened against prompt injections and malicious inputs at both the function and training levels. Note: Your proprietary data is never used to train our base models.
No, simply click the text box icon at the bottom right of the screen and URLMagic will automatically update the isolated environement for our AI and you can begin asking questions.
URLMagic CDN and Edge 🔗
URLMagic automatically configures CDN and Edge delivery without any configuration from you. It does so at the URL generation stage. Once the URL is generated, our CDN automatically detects the image is being requested, begins caching the image and
When an image is requested, our system instantly triggers a "pull-and-cache" sequence. The first request retrieves and optimizes the asset, while subsequent requests are served at microsecond speeds from our nearest Edge node. This is why your bandwidth records 0 because there is no to little transfer of actual data. It's cached and thus, reducing your bandwidth costs, automatically and without any special configuration.
335+ Global Points of Presence:
Your images are cached in data centers worldwide, ensuring that no matter where your user is; London, New York, or Tokyo, the image loads from a server just a few milliseconds away. Ensuring strong PageSpeed and Core Web Vitals.
Intelligent Edge Caching:
We utilize advanced caching logic to ensure your content is always fresh. We handle cache purging automatically when you update an image or collection, so your users never see stale content.
Optimized Protocol Delivery:
Assets are delivered via modern protocols (HTTP/3 and QUIC) to maximize throughput and minimize latency, directly contributing to superior Core Web Vitals.
Global Load Balancing:
Our infrastructure automatically reroutes traffic in the event of regional network congestion or outages, maintaining a 99.99% uptime for your visual assets.
Support and Community 🔗
Support is mostly handled by our AI via the dashboard since it's able to answer 99% of questions. We also have a Slack channel where questions can be answered, feature requestse raised and feedback taken. Join our Slack channel for more!
Status Page 🔗
All systems are currently operational.
API Reference 🔗
Coming soon... Contact us for more the waiting list or join our Slack channel for updates!