Assets are reusable pieces of content stored in the Knowledge Graph. They let you maintain a library of pre-approved text, photos, videos, and custom content that can be applied across entities, social posts, and review responses.

There are a few reasons to use assets:

• To quickly access frequently-used content
• To enable users to make updates easily
• To ensure that your team is using standardized, on-brand content

Common examples of assets include logos, product descriptions, stock images, and templates for social posts or review responses.

Before you start

Create an Asset

Assets are managed in Knowledge Graph > Assets. To create a new asset:

1. Navigate to Knowledge Graph > Assets.
2. Click the Add Asset dropdown and select the asset type: Text, Photo, Video, or Custom.
3. Enter the asset details. These vary based on the type of asset you are creating, which we will outline below. 
4. Click Save Asset or Save and Add Another.

Text Asset

To create a text asset, enter the following details: 

• Name
• Language (if you are using multi-language entity profiles)
• Content
• Usage: select the areas in Yext where you want to be able to apply your asset. Choose Entity Fields, Social Posting, and/or Reviews.
• Description
• Labels (optional): Asset labels can also be used to restrict which assets are available to a custom field. To do so, add a specific label to the asset, then add the same label to the custom field.
• For entities: choose which entities this asset can be applied to. You can narrow down entities by folder and/or entity label. (Note that entity labels are separate from asset labels.)

Photo Asset

To create a photo asset:

1. Enter the asset Name and Language. 
2. Click Select Photo and upload a file or enter an image URL. Accepted formats: JPG, PNG, WEBP, GIF (static only). 
3. Crop, rotate, or set an aspect ratio if needed, then click Done.
4. Set additional content details for your photo:
   • Description: If the asset is being used for Pages, this will display as the title of the photo.
   • Details: If the asset is being used for Pages, this will be the caption for the photo.
   • Alternate text
   • Click-through URL
5. Set the Usage (Entity Fields), Description, Labels, and For entities options.

Video Asset

To create a video asset:

1. Enter the asset Name and Language. 
2. In the Content section, click Select Video and choose whether to enter a Youtube URL or search YouTube.
3. Set the Usage (Entity Fields), Description, Labels, and For entities options.

Custom Asset

Custom assets enable you to quickly apply content that is properly formatted to fields using any custom field types you have created.

Before you can create a custom asset, you have to create a custom field type. To apply your custom asset, you will also need to create custom fields using your custom field type. See Create a Custom Field Type and Create a Custom Field for steps.

To create a custom asset:

1. Navigate to Knowledge Graph > Assets.
2. Click the Add Asset dropdown and select your custom field type.
   
   
3. Enter your asset details:
   • Name
   • Language (if you are using multi-language entity profiles)
   • Content: Depending on the subfields you have added to your custom field, you will see different options to configure.
   • Usage
   • Description
   • Labels
   • For entities
      

Edit an asset

1. Navigate to Knowledge Graph > Assets.
2. Click on the Edit button for the desired asset.
   • To edit assets in bulk: Select the checkboxes next to the desired assets, then click on the Edit button at the top of the Assets table.
     
     
      
3. Click on the field you would like to edit and make your desired change.
   
   
    
4. Click Save for (x) assets.

Apply an Asset

You can apply an asset by clicking the asset icon anywhere you see it while editing content in Yext.

Delete an Asset

Deleting an asset removes it from the library but does not remove the content from fields where it has already been applied.

1. Navigate to Knowledge Graph > Assets.
2. Click the dropdown arrow next to the Edit button for the desired asset and select Delete.
   
   
   
    
3. To delete assets in bulk: select the checkboxes next to the desired assets, click on the More Actions button, and select Delete.
   
   
    
4. Click Delete in the modal to confirm.
   
   

Use Asset Field Permission

Use Asset is a field-level permission. When enabled, the Use Asset permission grants a user the ability to use assets to make updates to fields without having to go through an approvals flow.

A user with this permission is not permitted to add any non-asset content to fields. This includes creating any new content (e.g., the user cannot create a new asset), making changes to an existing asset, or adding any content to a field that is not contained in an asset. If a user with the Use Asset permission attempts to make any of these types of changes, the Save button will be disabled.

The asset must be compatible with the field type in order to be used (e.g., a text asset could be added to a “Description” field).

On List type and Struct type fields, a user with the Use Asset permission can use assets to make partial updates to the field’s content. On singular field types (i.e., non-struct and non-list fields), a user with the Use Asset permission cannot make partial updates — they can use an asset to overwrite the content of the entire field, or they can delete the entire value of the field.

Below are allowed and disallowed actions by field type for users with the Use Asset permission:
 

Allowed Actions by Field Type

Singular Field Types (Non-Object, Non-List)

Structs

Lists

Use Asset and Request Edit Permissions

Users with both the Use Asset and Request Edit permissions can apply an asset directly to a field and save, or edit a field with non-asset content and submit it as an edit request. They can also apply an asset to a field and request it as an edit rather than saving directly, which routes the update through an approvals flow.