# Add live captioning to an event For Live events with StreamText captions only. The Webcast service does not have a built-in live captioning feature. However, you can create a custom tab and include real-time captioning delivered through the StreamText platform in your Live event. To include live captioning, you must request captioning services, set up a custom tab with the StreamText embed code, and then invite the captioner as an attendee. On the day of the event, the captioner joins as an attendee and types the captions into StreamText, which are then displayed to the audience in the custom tab. **Notes:** - You can't add live captioning to the archived version (replay) of a Live event. To add captions to an event replay, see [Add captions to a recorded event](https://help.webcasts.com/books/event-setup/page/add-captions-to-a-recorded-event). - Because live captioning is not a feature of this platform, Support is not able to set up, test, or manage captioning for self-service clients. If you would like someone to manage an end-to-end integration, contact your sales representative to arrange a consultation package. Jump to: [Request captioning services](#bkmrk-) | [Example code](#bkmrk--0) | [Set up the live captions tab](#bkmrk--1) | [Preview your work](#bkmrk--2) | [StreamText URL formatting](#bkmrk--3) # Request captioning services We can book live captioning for your event. **To request live captioning:** - If you have a Standard or Premiere plan, send us an email at . You can also use your own third-party captioning provider, as long as they use the StreamText platform. When you request live captioning through us, we provide your event ID to the captioning provider, who uses it to identify your event in their StreamText account. When you set up the custom tab, include this event ID in the embed code. If you schedule your own captioner, we recommend that you give them your event ID to use as their StreamText event name (identifier); confirm the value they used and include it in the embed code. To learn more about the process for scheduling captioning services, contact Support. # Example code Use the following example code to embed captions in the custom tab. In the code, find **event=1234567** in the code and replace **1234567** with the event ID for your event. If you're using your own captioning services, replace **1234567** with the event name provided by the captioner. **Important:** If you requested captions in a language other than English, you must include an additional language parameter to the link for them to display correctly. For example, if you requested captions in Spanish, you must add **&language=es** to the link after the event ID or name. For more information, see [StreamText URL formatting](#bkmrk--3). ``` ``` # Set up the live captions tab Sign in to the Webcast Admin portal and edit the Live event. **To add the live captions tab to an event:** 1. On the left panel, click the **Event Content** tab. 2. Under Optional Content, expand the **Add Custom Player Tabs** section and click **Add Sidebar Tab**. 3. Enter a name for the captioning tab and set Load As to **Open**. 4. Optional. The Q&A tab displays under the video player in your event by default. To have the captions display under the video player, enter 1 for the Display Order. 5. At the right side of the editor, click **</>** to switch to code view. 6. Delete all the placeholder code. 7. Copy the example code and paste it into the editor. 8. In the code, find **event=1234567** and replace **1234567** with the seven-digit event ID for your event or the event name. If your captions are in a language other than English, be sure to include the language parameter in the link. [![Sidebar tab setup for live captioning](https://help.webcasts.com/uploads/images/gallery/2022-05/scaled-1680-/oX4ozwTA2BFuWFIo-tab-sidebar-captioning.png)](https://help.webcasts.com/uploads/images/gallery/2022-05/oX4ozwTA2BFuWFIo-tab-sidebar-captioning.png) 9. Click **Save Changes** to save the coding. Then click **Save and Continue** to save changes to the event content. # Preview your work Always preview the tab setup before the Live event. **To test captioning for your event:** 1. In the Webcast Admin portal, edit the event. 2. On the Event Content tab, edit the sidebar tab you created for captioning and replace your event ID or name with **ihaveadream**. ...src="https://www.streamtext.net/text.aspx?event= **ihaveadream** &chat=false... 3. Click **Save Changes** to save the coding. Then click **Save and Continue** to save changes to the event content. 4. Now preview the web player: click the **Event Summary** tab and at the top of the page, click **View My Event** . Make any changes to the display. When ready, go back and place your event ID in the sidebar tab coding. # StreamText URL formatting The captions can be visually controlled by passing various query strings (parameters) in the URL. Here are the options used in our example code; we hide various elements to ensure captions display well in a sidebar tab. For a complete list of options, see [this StreamText help article](https://streamtext.zendesk.com/hc/en-us/articles/210923103-Controlling-the-streaming-text-page-display).
Query StringPurposeUsed in our example codeResult
languageRequired for displaying captions other than English. The ISO 639-1 code for the caption language. Examples: Chinese (Simplified) - &language=zh French - &language=fr German - &language=de Spanish - &language=es For a complete list of language codes, see [this Google article](https://cloud.google.com/translate/docs/languages). N/AEnglish captions
chatDisplays the chat box&chat=falseChat box hidden
headerDisplays the title and the controls&header=falseHeader hidden
footerDisplays gray footer with copyright&footer=falseFooter hidden
controlsDisplays a toolbar that allows each attendee to change the font, sizing, and other formatting of the captions they're viewing&controls=falseControls hidden
fsFont size&fs=1212 pt font
ffFont family&ff=ArialArial font
bgcBackground color&bgc=FFFFFFWhite background
fgcForeground color; sets the text color&fgc=00000Black text