Insites Docs Instance AssetsManaging Assets

Managing Assets

Last updated on August 01, 2024.

This article serves as a guide for the following topics:

  • Using Assets
  • File Tagging
  • Deleting Assets
  • Deleting a Folder
  • Viewing archived Assets
  • Restoring archived Assets

Using Assets

There are two ways of rendering assets on an Instance:

  • Liquid tags
  • Direct URL

Liquid tags

Liquid tags render HTML for content on pages, templates, and fields in a database layout or details page. To use Liquid tags:

  1. Choose Assets on the main menu.
  2. Select All Assets.
  3. Navigate to the folder where the target file is located.
  4. Click on the target file. Select the LIQUID TAG button on its details pane. This copies the Liquid tag to your clipboard.
  5. Paste the Liquid tag as needed on your code.

Direct URL

Use this method to render assets in Markdown. There are two ways to implement this method:

  • Root URL method
  • Relative URL method

Root method

The root URL method indicates the full file path to the image, including the base URL. You can use this method to access your images from an external site or instance. You can use either your custom domain or the system domain. This method references image(s) from a master Instance which means that whenever an image is updated in a master Instance, images in the child instance are updated as well. Usage of the root URL method is demonstrated in the example below:

Relative URL method

The relative URL method ensures that the Instance references images that are in itself rather than the Instance that it was copied from. This method is useful when you want stability on the particular Instance that you are developing on. Usage of the relative URL method is demonstrated in the example below:

File Tagging

You may associate keywords or 'tags' to your files to make them easier to search and filter. To add tags to a file:

  1. Select Assets on the main menu.
  2. Select All Assets.
  3. Navigate to the file that you want to add tags to.
  4. Select the target file and use the 'Tags' menu bar item () or click on the TAGS button on its details pane.
  5. Type the tags or keywords that you want to associate with this file on the 'File Tag(s)' modal.
  6. Click SAVE.

Deleting Assets

To delete a file or asset:

  1. Select Assets on the main menu.
  2. Select All Assets.
  3. Navigate to the folder where the file that you want to archive is located.
  4. Select the target file and use the 'Delete File' menu item (). You may also click on the DELETE button to delete your target file.
  5. Click DELETE on the confirmation modal.

Deleting a Folder

To delete a folder:

  1. Select Assets on the main menu.
  2. Select All Assets.
  3. Navigate to, or click on the folder that you want to delete.
  4. Click on the 'Delete Folder' menu item () and select DELETE on the confirmation modal. Take note that deleting a folder also deletes all the folders and files that it contains.

Viewing archived Assets

You may view archived assets on the Instance. To view archived assets:

  1. Select Assets on the main menu.
  2. Select All Assets.
  3. Click View Archived.

Restoring archived Assets

You may restore archived Assets so that they may be used on the Instance. To restore archived assets:

  1. Select Assets on the main menu.
  2. Select All Assets.
  3. Click View Archived.
  4. Select the file that you want to restore.
  5. Press the 'Restore' icon () on the Assets menu.
  6. Select RESTORE on the confirmation modal.
Have a suggestion for this page?

Didn't quite find what you are looking for or have feedback on how we can make the content better then we would love to hear from you. Please provide us feedback and we will get back to you shortly.