HomeGuidesAPILog In

Content Library

The SmartIQ content library provides a way to store re-usable content, such as text, images, document fragments, file-attachments, and fonts. These may include legal clauses, corporate logos, tables, graphs as well as fonts.

The actual content items are maintained in Manage.


Organizations can use a variety of fonts in their templates but only fonts installed on the SmartIQ server can be drawn upon at generation time, unless the fonts are specifically embedded into the document.

For more information, refer to Custom Fonts.

Content Library questions are used to place specific content items into the document in Design. You can also set content library questions to visible, which makes them interactive questions.

Content Library Question Types

SmartIQ supports the following types of content items:

Content TypeExtension Types
Attachment.doc .docx .pptx .xls .xlsx .odt .ods .odp .pdf .csv .txt .html .json .bmp .gif .jpg .jpeg .png .rtf .ics .xml .svg
Document Fragment.doc .docx
FontTrueType Font (TTF) TrueType Collection (TTC) OpenType (OTF)
Image.bmp .gif .jpeg .jpg .png
TextType content on the screen

Document Preparation

Standard or selection placeholders can be used throughout the document to specify where the content items are to be inserted.



SmartIQ will use available fonts in the Content Library when converting Docx, Pptx, and Xlsx templates to Pdf files, where the font must exist on the server. However, no additional steps need to be done in Design. For more information, refer to Custom Fonts.


How to add a content library question:

  1. From the toolbox, drag and drop a Content Library question onto a page, section column or tab.

SmartIQ automatically adds an answer to the new question. Then, set the question’s properties as below.

PropertyDescription / Examples
VisibleCheck to allow interaction with the question. The remaining properties are available only if Visible is checked.
Content TypeSelects the type of content to be expected.
Content ItemFor outputted content and display types a particular content item must be selected, use the ‘…’ button to search for an appropriate text content library item.
Auto AnswerAvailable if Visible is not selected. When checked, references another question to search for a specific filename in the content library.

  1. If the question is visible:

    • Drag and drop any placeholders that are to be populated by the user-selected content item onto the answer.

  1. If the question is invisible:

    • Use the Content Library tab to drag and drop an existing item onto the answer. If there are a large number of content items, use the Search field to filter the results.
    • Drag and drop any bookmarks that are to be populated onto the content item.

Document Fragment Placeholders

When you add a document fragment to a question set, it becomes available in the Placeholders tab for you to use any placeholders the fragment may contain in your question set. The fragment name is added to the Document Fragments element, with a list of its placeholders.

To use a document fragment’s placeholders simply expand the list of placeholders using the plus icon (), and drag and drop any relevant placeholders onto the question set.

You may locate a document fragment in the question set from the Placeholders tab by right-clicking on the fragment and choosing Find in Question Set from the pop-up menu. This will return a list of all instances of the selected fragment in the Find Results window.

Auto Answer Option

Content Library Question types include an option called "Auto Answer". This tab allows content library items to be:

  • Automatically attached at document generation time
  • Automatically inserted at document generation time

How to Implement an Auto Answer Question

Create the Questions

  1. Create a Text Field to capture a value.
  2. Add the Content Library question.

Setting Up the Content Library Question

  1. Set the question to invisible in the properties tab.
  2. Set the Auto-Answer tab to record the answer of the Document name text field.
  • Content Library Question WITH Placeholder - The matching content library doc fragments will be included IN the document.
  • Content Library Question WITH NO Placeholder - The matching content library doc fragments will be included as an attachment at Document Generation time.



If the user enters a name in the Document name text field, AND this name matches the name of an existing DOCUMENT FRAGMENT in the Content Library, then that Document Fragment will automatically be included as an attachment at document generation time - as in this case, there is no placeholder for the content library question.

Attachment Option

A Content Library question can be used to display a document for the user to review or download. This is achieved by setting Visible to checked on the Content Library question and selecting the Content Type of Attachment.

This combination of settings will display the "View Controls" for this Attachment. The View Controls determine how the question will look to the end user and what they can do with the selected attachment.

Possible options are:

View and DownloadDisplay the name of the Content Item with a View icon and a Download icon. Default selection.
View OnlyDisplay the name of the Content Item with a View icon only.
Download OnlyDisplay the name of the Content Item with a Download icon only.
Open (legacy)For backwards compatibility with existing projects, this option displays the name of the Content Item and an "open" link which allows a user to download the document.

The Content Items selection screen will determine which Content Item should be available for display or download.

The options which allow "View" will employ the embedded content viewing capability common with the File Selection Question. For further details and supported file types, see Viewing Uploaded Files.

Image Option

In Design, the Content Library question has an Image option, allowing the designer to display an image in their web form in an appropriate location.

  1. Click on the Content Item and a dialogue box will be displayed.
  2. The desired image can be filtered by Name, Category, and Content Folder.
  3. Click Search to select the desired image.

When the project is run in Produce, the image is rendered (of thumbnail size) and cannot be edited.

The size of the image can be altered inside the Content Library answer as shown below.



  1. If the content library question is mapped to a placeholder, it is replaced with the image (of original size) from the Content Library.

  2. Alternative Text, if configured in design, can be viewed in the generated document.

How to Add an Attachment File to Your Project Output

Sometimes you may wish to attach a file to your generated output. For example, in an email sent by SmartIQ, you may wish to have a company policy document attached.

To set this up, there are two steps you must take:

  1. Add the file to the Content Library.

  2. Add the Attachment to your SmartIQ Project.

    • Open Design and load your Project.
    • Add a Content Library Question to the Project.
    • Go to the Content Library tab and search for the file you added previously.
    • Drag the Attachment from the Content Library onto the Answer of the Content Library Question.

Now, whenever this Project is generated, the file will be included as one of the collection of documents generated.

Alternatively, you may wish to have a user select a particular file from your Content Library which running your Project from Produce. To allow this, perform the following steps:

  1. Open Design and load your Project.
  2. Add a Content Library Question to the Project.
  3. On the Properties tab of the Content Library question, check "Visible".
  4. Set Content Type to "Attachment".
  5. Ensure Display Type is "Search".

This will now include a Content Library Question on the Form when run in Produce. A User can search for and select an Attachment from the Content Library which will be included in the generated Documents.

The "Restrict by Folder" option allows you to refine which Attachment items from the Content Library are available for selection by the user. Only Attachments in the defined Content Folder will be available to be selected.

If the Attachment is referenced from elsewhere in the document (for example it may be referred to as "Appendix A"), you can define the name the Document will have in the "Attachment Name" field. This field supports question references.