Digizuite App Installation Guide

Digizuite is a comprehensive digital asset management (DAM) platform designed to help organizations centralize, organize, and efficiently manage digital content. It offers asset storage, metadata management, collaboration tools, and customizable workflows to streamline digital content processes and enable seamless access and distribution of digital assets across the organization.

Digizuite supports a wide range of file types, including common image, video, audio, document, and design file formats. It can handle popular file types such as JPG, PNG, GIF, MP4, MOV, MP3, PDF, DOCX, XLSX, PSD, and AI. This broad file-type support allows organizations to manage diverse digital assets within the Digizuite platform.

After installing the Digizuite app from the Contentstack Marketplace, you can use it within your stack to manage, store, and distribute the digital assets from the Digizuite account within your entries.

Prerequisites

• Digizuite account
• Contentstack account
• Access to the Contentstack Organization/Stack as the Owner/Admin

Let's follow this step-by-step guide to install and configure the Digizuite app within your stack.

Steps for Execution

1. Retrieve the Credentials for your Digizuite account
2. Install and Configure the Digizuite app in Marketplace
3. Use the Digizuite app within your entry

1. Retrieve the Credentials for your Digizuite account

   Go to the Digizuite website and click the BOOK A DEMO button at the top right corner to book a demo with the Digizuite team.

   During the demo call, the Digizuite team will learn about your configuration requirements. You will be provided with a Unified Dam URL and Media Format ID by the Digizuite team. You will also get the Digizuite username and password to log in to your Digizuite account for the first time when adding assets from the selector page in step 3.

   If you have any queries, you can contact the Digizuite Support team.

2. Install and Configure the Digizuite App in Marketplace

   To install the app in Contentstack, log in to your Contentstack account and follow the steps below:

   1. From the left-hand side primary navigation, click the Marketplace icon.
   2. Click Apps from the left panel.
   3. Within the Marketplace, you can see all the available apps. Hover over the Digizuite app and click Install.
   4. In the pop-up window, select the stack where you want to install the Digizuite app, accept the Terms of Service, and click the Install button.
   5. On the Configuration screen, enter the following:
      1. Unified Dam URL: Enter the Unified Dam URL retrieved from your Digizuite account in step 1.
      2. Media Format ID: Enter the Media Format ID retrieved from your Digizuite account in step 1. It must be a numeric value.
      3. Choose the Digizuite Keys to Save in Entry: Choose how to save the data fetched from the Digizuite account in Contentstack entries.
         1. If you select the All Fields option, you can select only a limited number of videos in the entry.
         2. For Custom Fields, you can search and add specific Vimeo Keys you want to save in entries.

            Note: When you change the settings from All Fields to Custom Fields, and vice versa, any existing assets will follow the old configuration settings, whereas newly added assets in the entry will store the data according to the updated configuration settings. This is applicable to Custom and JSON RTE fields.

         

         If you select Custom Fields then the Digizuite Keys drop-down appears. By default, title, itemId, thumb, downloadUrl, and assetType keys are already selected inside the dropdown. If you want to create a new key, click the + New Key Field option.

         

         In the Add Digizuite Key Path modal, enter the Digizuite Key Path and click the Create or Create and Apply button to create a new key.

         
   6. Click the Save button.
   7. On the UI Locations tab, you can see the predefined app locations. You can use the toggle button corresponding to each UI location to enable or disable it based on your requirements.

      Additional Resource: For more information on UI locations, please refer to the Installed Apps guide.

   8. Click Open Stack to start using the Digizuite application.

3. Use the Digizuite App within your Entry

   To use the Digizuite app within an entry of your stack, follow the steps given below:

   1. Go to your stack, click the Content Models icon from the left navigation panel, and click the + New Content Type button.
   2. Create a content type by adding relevant details as displayed below:

   There are two ways to use the Digizuite app in your entry:

   1. Custom Field
   2. JSON Rich Text Editor Field

   Steps to Use the Digizuite App in a Custom Field

   1. In the Content Type Builder page, add a Custom field in your content type by clicking the Insert a field link represented by a + sign.
   2. Under Select Extension or App, select Digizuite and click the Proceed button.

      This adds Digizuite to the custom field.

      
   3. After adding the app in a custom field, click Save or Save and Close to save your changes.
   4. To use the Digizuite app, create an entry in this newly created content type. In the left navigation panel, navigate to the Entries page, click + New Entry to create a new entry for the above content type, and then click Proceed.

      You can see the Digizuite app’s custom fields on your entry page, as shown below:

      
   5. Click + Choose Asset(s) button.

      Note: If you are using the Digizuite app for the first time, the app will redirect you to the Digizuite login page after clicking the + Choose Asset(s) button. You need to authenticate the credentials.

      
   6. Now, you can choose assets from the Digizuite selector page:
      1. To add a single asset, you can hover over the asset and click the Place icon to add the asset in the custom field.
      2. To add multiple assets, select the required assets from your Digizuite account, click the Selected dropdown, and then select the Multi Insert option to add them to your entry.
      3. In the Insert rendition modal, confirm the final version and click Insert to add assets in the entry.
      4. Also, you can view all the selected assets by clicking the Selected dropdown, and then select the Show Selection option.
   7. The assets you select get added to your entry in the thumbnail view.

      To view the assets in the list view, select the List view option from the dropdown.

      

      The assets you select get added to your entry in the list view.

      
   8. Hover over the image to view the options to reorder, preview, and remove the asset.
      1. Click the Reorder icon to drag and reorder the asset.
      2. Click the Preview icon to preview the asset.
      3. Click the Remove icon to remove the asset.

      Thumbnail View

      

      List View

      
   9. After adding the asset(s), Save and Publish your entry.

   Steps to Use the Digizuite App in a JSON Rich Text Editor Field

   1. In the Content Type Builder page, add JSON Rich Text Editor in your content type by clicking the Insert a field link represented by a + sign.
   2. Under Select Plugin(s), select Digizuite, and then click Add Plugin(s).

      This adds Digizuite in the JSON Rich Text Editor.

      
   3. After adding the app in a JSON Rich Text Editor field, click Save or Save and Close to save your changes.
   4. To use the Digizuite app, create an entry for this content type. In the left navigation panel, navigate to the Entries page, click + New Entry to create a new entry for the above content type, and then click Proceed.

      You can see the Digizuite icon in the JSON Rich Text Editor field on your entry page, as shown below:

      
   5. Click the Digizuite app icon.

      Note: If you are using the Digizuite app for the first time, the app will redirect you to the Digizuite login page after clicking the + Choose Asset(s) button. You need to authenticate the credentials.

      
   6. Now, you can choose assets from the Digizuite selector page:
      1. To add a single asset, you can hover over the asset and click the Place icon to add the asset in the custom field.
      2. To add multiple assets, select the required assets from your Digizuite account, click the Selected dropdown, and then select the Multi Insert option to add them to your entry.
      3. In the Insert rendition modal, confirm the final version and click Insert to add assets in the entry.
      4. Also, you can view all the selected assets by clicking the Selected dropdown, and then select the Show Selection option.
   7. The assets you select get added to your entry.
   8. To resize the image, drag the corner of the image and adjust the size as required. Hover over the image to view the options to Preview, Edit, and Remove the asset.

      Additional Resource: You can use alignment and inline asset features to edit the asset placement within the JSON Rich Text Editor field.

   9. After adding the asset(s), Save and Publish your entry.