Setting up
Logo requirements
What makes a logo work in the inbox, how we convert yours to the required format, and how you approve the result.
Inboxes show your logo as a small circle next to your name. They need it in a very specific file format, SVG Tiny P/S. You don't need to create that file: give us your logo and we prepare it.
What to give us#
Any of these works:
- An SVG file of your logo (best). Ask your designer or check your brand guidelines.
- A link to your logo file online.
- The logo on your website. We look for it automatically; you just confirm.
The file can be up to 512 KB. If you only have a PNG or JPG, we'll tell you; a vector version (SVG, or a PDF/EPS from your designer) gives the best result.
What makes a logo look good in the inbox#
- Square. The logo is shown in a circle, so a square layout with some breathing room around the mark works best.
- A solid background. Use your brand color or white behind the mark, rather than a transparent background.
- Simple and bold. It's shown small. A symbol or monogram often reads better than a long wordmark.
- The same as your trademark if you want the blue checkmark. See Trademarks.
What we do to your logo#
- We keep your original file exactly as you gave it, separately.
- We create an inbox-ready copy in SVG Tiny P/S: a square canvas, a title with your company name, and without the features the format doesn't allow (scripts, embedded images, animations, external links, some effects).
- We compare the two visually and list every change we made, flagging any that alter how the logo looks.
- You review them side by side and approve the version that will be used.
Some advanced design effects can't be carried over exactly. When that happens, we tell you, and you can provide a simpler version.
Approval#
In the setup phase, you approve the exact inbox-ready file. Nothing is sent to the certificate issuer until you do. If you change your logo later, we can prepare a new version and reissue your certificate.
For developers#
PUT /v1/applications/{id}/logowith{ "svg": "…" },{ "url": "https://…" }or{ "use_discovered": true }.GET /v1/applications/{id}/logoreturnsstatus,analysis(compliance issues),changes(with alossyflag),visual_diff(identical,minor,significant) and URLs for the original, converted and PNG previews.POST /v1/applications/{id}/logo/approvewithconverted_sha256approves exactly the reviewed file (paid step).- Uploaded SVGs are size-limited, never rendered inline, and served with a restrictive content security policy; links are fetched through a protected fetcher.