Viewing Available Content Name and Alt Text in Doclets

When you embed available content in your Word or PowerPoint doclet using Smart View, you can view the available content name or title. This allows you to quickly identify the available content when working in a doclet. You can also view or use screen readers to read the alt text for the embedded available content, if set.

Reading Alt Text for Embedded Available Content

If alt text has been set for available content, you can view it or read it when embedded in Word or PowerPoint doclets as follows:

  • If Name is set as alt text, then the Display Name added for the available content appears as the alt text for images. For tables, the Display Name appears as the Alt Text Title in the Table Properties dialog box.

  • If Description is set as alt text, then the text added in the Description field for the available content appears as the alt text for images. For tables, the Display Name appears as the Alt Text Title and the Description appears as the Alt Text Description in the Table Properties dialog box.

  • If Custom is set, then the text added in the Custom Alt Text field for the available content appears as the alt text for images. For tables, the Display Name appears as the Alt Text Title and the Custom Alt Text appears as the Alt Text Description in the Table Properties dialog box.

In the following example, while defining available content "Cost of Sales", a custom alt text has been added for the table.


Define New Available Content dialog box displaying the provided name, description, and alt text.

When this available content is inserted in a Word doclet, the alt text can be viewed or read in Table Properties as follows:


Table Properties in Word displays the set alt text for the embedded available content

Viewing Name of Embedded Available Content

The available content name is displayed when you select an embedded content in a doclet. For example, in Word, the name is displayed above the embedded content:


Embedded content selected in a Word doclet, the embedded content title, Summary Income Statement, is displayed

In PowerPoint, to view an embedded content name, select the embedded content, right-click and, depending on your Office version, select View Alt Text or Edit Alt Text. The title of the embedded content appears in the Alt Text panel.

When available content is embedded using the Narrative Reporting extension 23.10+, you can view the name whenever you select an embedded content within a doclet.

If you have content that was embedded in a Word or PowerPoint doclet using a Narrative Reporting extension version earlier than 23.10, or embedded using the Narrative Reporting web interface, the available content name is not included so the names are not displayed in the doclet. Complete the following procedure to display the embedded content names.

To display the titles of existing embedded content in a doclet:

  1. Open a doclet containing existing embedded content and check it out.
  2. In the Narrative Reporting ribbon, click the drop-down menu on the Refresh button, and select Refresh Embedded Content.
  3. Upload the doclet and check it in.
  4. When the refresh, upload, and checkin is complete, select any embedded content in the doclet to view its name.
  5. Optional: Perform a checkout to continue working on the doclet.

Note:

You must open and check out a doclet in Smart View, perform a Refresh Embedded Content, then upload and check in the doclet to ensure that the available content name displays correctly in these situations:

  • When content is embedded in a Word or PowerPoint doclet from Narrative Reporting web
  • After changing the name of an available content from Narrative Reporting web or from Smart View