This article explains how to add, rotate, crop, arrange, and delete photos on entities. For more information on the size and format recommendations for photos for specific publishers, see Photo and Video Guidelines for Publishers.
- Click Knowledge Graph in the navigation bar and click Entities.
- Click on the entity you would like to edit.
- Click Media in the left sidebar.
-
Click on the pencil icon next to the Business Logo or Photo Gallery field and make your desired change.
- If you already have a Business Logo added, you will need to delete the existing image before you can add a new one.
Add a Photo
When adding new photos, you can upload a new image (via an image file or image URL), or select one from your asset library.
- In the field you are editing, click Select Photos and choose from the options in the modal:
- Drag and drop an image file directly into the box
- Click Upload Photos to choose an image file
- Click Enter URLs to enter an image URL
- Click Select Assets to choose one of your existing photo assets in Yext. See Add a Photo Asset for more information.
-
Add your desired description, caption, alternate text, and click-through URL.
- Description: A title or brief description. Although there is no character limit for this field, publishers typically accept photo descriptions that are 100 characters or less.
- Details: Additional information besides the description.
- Alternate Text: A description of what is in the image. Alt text is read by screen readers for those who are visually impaired and can display in place of an image if it fails to load.
- Click-through URL: Hyperlink the image.
Edit, Rearrange, and Delete a Photo
To rotate, crop, or apply an aspect ratio to a photo, hover over the photo and click Edit. Once you have made your desired adjustments, click Done.
To delete a photo, click on the trash can icon () to the right of the photo.
To arrange the order of photos in a Photo Gallery field, drag and drop by clicking on the three lines () to the left of the desired photo. Note that not all publishers may respect the chosen photo order.
Yext Knowledge Graph Photo Guidelines
Below are the size and format guidelines for photos and videos on entities in the Knowledge Graph that will sync to listings on publisher sites.
There are specific guidelines for storing photos on the Business Logo and Photo Gallery fields in the Knowledge Graph, as well as specifications for photo fields on Apple, Facebook, and Google. Google also has specifications for the Google Video Gallery field.
By default, the Business Logo and Photo Gallery fields in the Knowledge Graph are eligible to sync photos to listings.
Preferred File Formats
- JPG
- JPEG
- PNG
Business Logo Field
- Maximum file size: 5MB
- Maximum dimensions: 400px x 400px
Photo Gallery Field
- Maximum file size: 5MB
- Minimum dimensions: 180px x 180px
- Although Yext will accept photos with the minimum dimensions, the recommended minimum for many publishers is 250px x 250px.
- Maximum Dimensions: 30,000px x 30,000px
- Although Yext will accept photos with the maximum dimensions, the recommended maximum for many publishers is 5,000 px x 5,000 px.
- Maximum number of photos: 500
- Although the maximum number of photos allowed for each entity is 500, photo limits vary by publisher.
Image Storing and Serving
The Knowledge Graph supports a range of image storage capabilities to ensure that images can be served flexibly on digital experiences.
Once a photo has been uploaded to an entity, there are multiple ways to specify how that photo should be displayed for downstream use (i.e., any source that would refer to that image on your entity, such as Search, Listings, or Pages.)
Storing Images
Photos can be stored on entities in fields of either the Photo or File field type.
| File Field Type | Photo Field Type | |
|---|---|---|
| Validate height, width, and aspect ratio | No | Yes |
| Validate file size | Yes | No |
| Use dynamic links (dynl, dynm) | Yes | Yes |
| Dynamic image transformation and resizing | Yes | Yes |
Image Field Behavior
Certain built-in image fields have specific behavior:
| Field | Details |
|---|---|
| Logo | Photos uploaded to the Logo field are automatically padded to fit a 1:1 aspect ratio. This does not apply to the EU source region. EU users must format photos to a 1:1 aspect ratio before uploading. See the Unsupported Features in EU Source Region reference for more information. |
| Legacy Rich Text (v1) fields | External images in Legacy Rich Text fields will not render in Entity Edit (for CSP compliance). This does not affect downstream use as images will still render in Search and Pages. Photos render normally in Entity Edit on all Rich Text (v2) fields. See the Rich Text (v2) and Markdown Field Types reference for more information. |
Serving Images
When referencing images in downstream uses (Search, Pages, Listings), the hosting base URL should be changed to a Yext image serving base URL. For example, a.mktgcdn.com should be changed to dyn.mktgcdn.com, dynl.mktgcdn.com, or dynm.mktgcdn.com.
Using a Yext serving URL allows you to specify the size and transformation of the image.
File Type Guidelines
| Format | Best For |
|---|---|
| JPEG | Photos and images with a wide range of colors |
| PNG | Clip art or vector art with a limited color palette |
| WEBP | Can handle both use cases well and encodes images into a smaller file at the same level of quality. This format is recommended for web page serving. However, not every application can read this format. |
Dynamic Image Transformation
Photos used in Yext are hosted and served on Cloudflare, which supports a variety of image transformations via path parameters in the serving URL. See Cloudflare's documentation for the full list of options.
Note: Dynamic image transformation is only available for photos under 100 megapixels (Photo and File field types). GIF serving is not currently supported — Cloudflare transform options such as
animwill not work. Only Cloudflare-supported image formats are eligible for transformation.
If you are transforming a file field type URL to be served, a.mktgcdn.com/f/{businessID} should be adjusted to dyn.mktgcdn.com/p/.
If you are transforming a photo field type URL to be served, a.mktgcdn.com should be adjusted to dyn.mktgcdn.com and the dimensions and extension at the end of the URL should be dropped.
The served image URL should have the following format: https://dyn.mktgcdn.com/p/{image_UIUD}/{options}
Example: Applying blur, 1000x1000 crop, and 90-degree rotation to a photo
The process would be as follows:
- Fetch the hosted URL:
https://a.mktgcdn.com/p/weDfOuuWD5IybzlazwEUUps4-NxElRV2E2O0_zOXE6U/1701x1295.jpg - Change the base URL to
dyn.mktgcdn.com:https://dyn.mktgcdn.com/p/weDfOuuWD5IybzlazwEUUps4-NxElRV2E2O0_zOXE6U/ - Add the transforms:
https://dyn.mktgcdn.com/p/weDfOuuWD5IybzlazwEUUps4-NxElRV2E2O0_zOXE6U/blur=20,height=1000,width=1000,fit=crop,rotate=90
Note that Yext does not currently support serving GIFs, so using Cloudflare transform options such as anim will not work.
Using Served Images on React Front-Ends
Use the Image component to serve photos from the Knowledge Graph into downstream experiences.
Generated Thumbnails (Legacy)
Before leveraging the dynamic transform options in Cloudflare, Yext would proactively generate a set of thumbnails in various sizes for any uploaded image.
Today, Yext will still generate these thumbnails when a photo is uploaded, however, we recommend leveraging the dyn.mktgcdn.com base URLs and Cloudflare resizing for more granular control over served images. To optimize for page speed and ensure that all devices can render images correctly, we create a set of thumbnails at several sizes and normalize the image format to something that all devices can consume.
Using Thumbnails on Your Site
Thumbnails are created using your photo’s original dimensions, in addition to thumbnails which are scaled to fit within each of these fixed bounding boxes:
- 1900x1900
- 619x1000
- 600x450
- 196x400
The photo is never enlarged, nor is the aspect ratio changed.
Thumbnails can be accessed using URLs of the following format:
FIT.mktgcdn.com/p/UUID/WIDTHxHEIGHT
Similar to dynamic photo serving - if you are using a file field to store photos and wish to serve them, the base URL needs to be changed from a.mktgcdn.com/f/{businessID}/UIUD to FIT.mktgcdn.com/p/UIUD/WIDTHxHEIGHT.
FIT specifies one of two modes that allow dynamic selection among a set of thumbnails:
-
dynl.mktgcdn.com— “at least” as large, on one dimension -
dynm.mktgcdn.com— “at most” as large, on either dimension
This dynamic URL will return the thumbnail which is the best fit for the given FIT and dimensions.