You can create content that combines a variety of materials to view together, such as text, multimedia, and attachments.

You can create a content item to present a combination of content that serves as a handout or document with visual aspects. You can create content items that are as simple as one line of text or include many elements.

For example, in one content item, you can include introductory text for a lesson, an image, a table of data, and links to web resources. The materials are all presented together in the content list. The longer your content item is, the more your students have to scroll to see all the other materials in the content area.

If you don't want longer content items to appear in the content list, you can create blank pages instead. You create a blank page in the same way you create a content item. However, students select the blank page link in the content area to view the materials. Blank pages save screen real estate and reduce the amount of scrolling.

Create a content item

Doesn't seem familiar? Jump to the "Ultra" help about creating documents.

  1. In a content area, learning module, lesson plan, or folder, select Build Content to access the menu and select Item.

    Be sure Edit Mode is ON so you can access all of the instructor's options.

  2. Type a name and an optional description or instructions. You can use the options in the editor to format text, attach files, embed multimedia, and insert equations, links, and tables. You have creative control over how your content appears and the flexibility to change the order and appearance when you want.

    More on embedding multimedia

  3. In the Attachments section, select Browse My Computer to upload a file from your computer. The file is saved in the top-level folder in your course's file repository: Course Files or the Content Collection. You can also attach a file from the repository.


    Drag files from your computer to the "hot spot" in the Attach Files area. If your browser allows, you can also drag a folder of files. The files will upload individually. If the browser doesn't allow you to submit your item after you upload a folder, select Do not attach in the folder's row to remove it. You can drag the files individually and submit again.

    You won't be able to drag files to upload if your institution uses an older version of Blackboard Learn.

    You can use the file name or provide another name for the file.

  4. Select the appropriate options for availability, tracking, and display dates. Display dates don't affect an item's availability, only when it appears.

After you submit, the new content item appears last in the content list.

You can email a link to a file you add to a content item. In the Content Collection or Course Files, access the file's menu and select 360° View. Copy the permanent URL address and paste it in an email.

Choose file download location

In most browsers, you can select where the files that you open in courses are downloaded. For example, in Chrome, navigate to Settings > Advanced > Downloads. You can select the location for file downloads and choose if you want the browser to ask each time. In Safari, you have the same capabilities. Navigate to Preferences > General > File download location. You can perform an internet search to learn about file download choices in other browsers.

Edit and move content items

You can change the item's content at any time. Open the item's menu and select Edit.

You can change where the item appears in the list with the drag-and-drop function or the keyboard accessible reordering tool.

What happens to content items if I preview the Ultra Course View?

Your content items become documents in the Ultra Course View. You may see some loss of formatting to text and files that you added in the editor. Learn more about Ultra documents in the next sections.

More on previewing the Ultra Course View

ULTRA: Create a document

Doesn't seem familiar? Jump to the "Original" help about creating content items.

On the Course Content page, you can create a document or page to present a combination of content. For example, you can include introductory text for a lesson, an audio file of a lecture, and an image. When students select the document title, the materials you added are all presented together on one page. Students see the content just as you see it, without the editing options.

Select the plus sign wherever you want to add a document. In the menu, select Create to open the Create Item panel and select Document. The New Document page opens.

You can also expand or create a folder or learning module and add a document.

New Document page

On the New Document page, use the options to add content. You can add as many text blocks and files as you want.

Upload from Cloud Storage: You can upload files from cloud storage, such as OneDrive® and Google Drive™. When you add a file from cloud storage, the system makes a copy of the file in your course. The files aren't linked. Any change you make to a file within your course doesn't apply to the file in cloud storage. If your browser allows, media files display inline.

  • Type a title. On the Course Content page, the title appears as the link students select to view the materials. If you don't add a title, New Document and the date appear in the content list.
  • Add text blocks. Select Add Text to open the editor. You can also paste text from a Word doc.

    You can also use the editor to embed images and attach files along with your text. To use your keyboard to jump to the editor toolbar, press ALT + F10. On a Mac, press Fn + ALT + F10. Use the arrow keys to select an option, such as a numbered list.

  • Add files. Select Upload from Computer and browse for or drag files from your computer, such as a Word doc and an audio file. You can't add a folder of items. You're asked if you want to add the individual items inside the folder. Your institution controls the maximum size of a file that you can upload.
  • Add Office 365 files.You can embed enterprise Office365 files directly into your content. Select Share in your Office365 file to create a link to the file. Choose which permissions you want the user to have and select Copy Link. This copies the link to your clipboard. To embed the content, select Insert/Edit Media from Web from the editor. Paste the link in Media URL.Select Insert.

    More on how media files appear

  • Show or hide the document. Students can't see a document until you choose to show it. You can create all your content ahead of time and choose what you want students to see based on your schedule. You can also set availability conditions based on date, time, and performance on other items in the course gradebook. On the Course Content page, students can see when the document is set to be available.
  • Allow class conversations. What if your students have questions? You can allow conversations within a document, and anyone can contribute. Select the Settings icon to open the Document Settings panel and select the conversations check box. As the conversation develops, it appears only with the document.

    More on conversations

  • Add goals and standards. You and your institution can use goals to measure student achievement across programs and curriculums. When you create a document, you can align one or multiple goals. In the document, select the Settings icon. Select Align with goals to search for available goals to align with the document. Students won't be able to see the goals you align with a document.

    More on how to align goals with course content

  • Add an optional description. The description appears with the document title on the Course Content page. Content item descriptions are limited to 250 characters.


Add custom HTML or CSS

In Ultra Course View, when you enable an alternate domain for your site, you can now use custom HTML or CSS in a document.  Select Add HTML as a new block to embed an inline third-party HTML editor in the document. You can write or paste HTML code into the editor and select Save. The encoded HTML will be sent to Learn within BbML for persistence. The HTML will be denoted in the BbML with a new data-bbtype. If you load previously created BbML containing HTML in read-only mode, the HTML will be loaded from a separate domain in an iframe.

A new CodeEditor package handles all of the imports required by the third-party editor and standardizes the editor configurations. The package will otherwise simply wrap the editor's method for injecting itself into a DOM element. Directives and plugins that embed the editor on the page will depend on the package.


Your institution needs to have an alternate domain configured and the Course Role needs to have the Add/Edit embedded content scripts into iframe enabled for the Add HTML option to appear. If you don't see the option, please contact your site administrator. We're working on automating an alternate domain for all sites. Work on this automation is expected to be completed within the coming weeks. 

Word count in the editor

As you type in the editor, the word count appears below the editor. After you save, the word count no longer appears.

These items are included in the word count:

  • Individual words
  • Web links
  • Text in bulleted or numbered lists, but the bullets or numbers themselves aren't included
  • Superscript and subscript text not part of another word

These items and formatting elements don't affect the word count:

  • Images, videos, and file attachments
  • Math formulas
  • Blank spaces and lines
  • Alternative text

When you use punctuation to attach words or numbers, the count is affected. For example, "We went...without you" is counted as three words. The words or numbers on either side of the punctuation are counted as one word.

Add more content

After you add your first piece of content, select the plus sign wherever you want to add more content. You can add as many text blocks and files as you want, wherever you want.

Save your document

After you save, the document appears in the content list. You can change the document's content at any time and change the order of the items you added to the document.

In their activity streams, students are notified a new document is available.

ULTRA: Edit, reorder, and delete documents

Doesn't seem familiar? Jump to the "Original" help about managing content items.

You can make changes to existing documents and change where they appear on your Course Content page. Press the Move icon in a document's row and move it to a new location. You can also move a document into an expanded folder.

In a document's row, open the menu to select Edit, Conversations, and Delete.

You can use your keyboard to move a document.

  1. Tab to an item's Move icon.
  2. Press Enter to activate move mode.
  3. Use the arrow keys to choose a location.
  4. Press Enter to drop the item in the new location.

Delete documents

You can delete a document from your course or hide it from students to preserve the information. Students can't access hidden documents on the Course Content page.

Edit documents and media files

Based on the document element, you can move, edit, delete, or download it.

Open an element's menu to access the options. Press the Move icon to move an element to a new location on the document page.

Select the plus sign wherever you want to add another file or text block on the document page.

Media viewing options

If your browser allows, media files you add to documents display inline by default. If your browser can't display a media file inline, it appears as an attachment.

Images that display inline are embedded in a 768-pixel block at the biggest breakpoints. The closer to that size the images are, the less padding appears around them.

You can also add alternative text to describe images you add. Alternative text is read aloud by screen readers and helps describe what some users can't see.

You can edit the file's settings, including the display name, alternative text, and display behavior. Choose whether to insert the file as a link in the editor or to embed the file directly so it appears inline with other content you've added. To edit the file's alternative text or display behavior, select the file in the editor and then select the Edit Attachment icon.

More on adding files, video, images, and audio

In most browsers, you can select where the files that you open in courses are downloaded. For example, in Chrome, navigate to Settings > Advanced > Downloads. You can select the location for file downloads and choose if you want the browser to ask each time. In Safari, you have the same capabilities. Navigate to Preferences > General > File download location. You can perform an internet search to learn about file download choices in other browsers.

ULTRA: What happens during copy and import?

You can import an Ultra course or copy all the content from one of your courses on the system into another Ultra course. The new content is added to the end of the content list of the course you're in.

More on importing content

More on copying a course

More on copying content from other Ultra courses

When you import Original content or choose to preview your Original course in the Ultra Course View, content items are converted to Ultra documents. All text, attachments, and links that you added in the editor are converted and media files will open inline by default. Files that you added as attachments in the section after the Original editor are grouped together in alphabetical order at the end of the Ultra document. Media files will open inline by default. You can edit images, video, and audio files to change the default and change any file's title. Students will need to download some file types to view them.

More on Original content items

Review the document as you may see some loss of formatting during the conversion process. For example, if you added a title for one of your files in the Original Course View, the title may not appear in Ultra. You can edit the file to change the file name. You can reorder the items in the document as needed.