> This page is for Help center. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://fiftytwo-demo.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://fiftytwo-demo.ferndocs.com/_mcp/server. # Manage audio in ViKING POS Designer Audio on certain user actions, for example when users tap certain buttons, can greatly enhance the POS experience. This is especially true for [self-service checkouts (SCOs)](/help/pos/sco) where customers don't necessarily have much experience of using the POS. Audio can, for example, be a simple click sound that provides subtle feedback when a user taps a button, or it can be more advanced spoken help messages that guide users in their preferred language. In [ViKING POS Designer](/help/pos-designer/wpud) you can add audio [resources](/help/pos-designer/resources) to the following actionable [components](/help/pos-designer/component): * Button * ButtonGroup * GridMenu > **Info** > > The GridMenu component itself can't have audio, but each cell in a grid menu can have audio. * Keyboard * LanguageSelector * Menu > **Info** > > A parent Menu item can't have audio, but any children Menu items under the parent Menu item can have audio. * PanelButtons * QuantityStepper * StateButton * Total * Tabgroup * ViewGroup On each component, you can furthermore specify which events, for example click events, scroll events, etc. should trigger the audio. ## Add audio resources You can use audio files of the following formats: * .mp3 * .wav * .ogg * .aac * .m4a To add a new audio file to a diagram, open the required diagram, and attach the audio file to the diagram's **Audio** resource group. The audio file then becomes selectable when you set up audio on a component. See [ViKING POS Designer resources](/help/pos-designer/resources) for more information about how to attach a file to a resource group. ## Audio in different languages ![Vign languages](/_fern-files/_img/ccb2b11201f1943985247793afb4758689d728cdd8e26af125bc3d2f9e78ac54.webp) Many retail organizations operate in multilanguage environments, where they let users select their preferred language on POSs. In such cases, it's important that relevant audio files are also available in the languages that your organization supports on your POSs. That way you can provide a consistent user experience. * **Simple audio files, such as click sounds, etc.** typically don't require localization. That means that they don't require separate versions for individual languages, although you can choose to occasionally use different language versions of such files for cultural reasons. * **Audio files that contain spoken word messages** must typically be available in the languages that you offer on your POSs. Many organizations use spoken word audio files on their self-service checkouts, where spoken word messages can help guide users, especially visually impaired users. When you set up audio on a component, you'll be able to select different audio files for each language if required. ## Set up audio on a component You can set up audio on a component in two ways: * **Globally:** When you set up audio globally for a component, the audio will apply for that component wherever it's used on the diagram. This is useful if, for example, you always want a button to trigger a particular audio file when users tap that button, wherever that button appears on the POS display, now as well as if you later add a new instance of the button to the diagram. * **Locally:** When you set up audio locally on a component, it only applies for that particular instance of the component. This is useful if, for example, you only want a particular instance of a button to trigger a particular audio file when users tap that specific button. For each component, you can furthermore select different audio files for different languages if required. The ability to select different audio files for different languages applies for both global and local setups. ### Set up audio globally on a component > **Info** > > Before you begin, make sure that you've added the required audio files to the diagram (see Add audio resources in the previous) so that you can select them in the following. 1. In the bottom part of the dark bar in the right side of POS Designer, click the Audio icon: ![Audio rightbar](/_fern-files/_img/82f094a9f35a334a9559c1720c716954e4d9a8a9e75b0dd9085bb8caaa4f91b8.webp) 2. In the **Add / edit audio** dialog that opens, click ![Wpud addplus circle](/_fern-files/_img/23faefcab912da74784c6594e9f743c7c3ea3b56dfbae0c8abf4a76c3c23ff7a.webp) . 3\. In the **Control** field, select the component that you want to set up global audio on. 4\. In the **User activity events** field, select the event(s) that should trigger the audio. 5\. In the **Select audio for each language** section, click each required language and select the audio file to use for the language in question. 6\. Below the language selection section, select the required volume level by dragging the slider to the required level (0 (min.) - 100 (max.)). ![Wpud audio adjustslider](/_fern-files/_img/d60d06264ba1d6150a2dfd9d108ca4c93a4df53a08fc3416376ac2a48b1d6406.webp) The volume level is tied to the selected events on the selected component, so if you've selected different audio files for different languages on the component, the volume level will apply for all of the languages. #### You can also adjust volume level in ViKING POS. How does my audio level selection in POS Designer affect that? The default audio level in ViKING POS is 100, so if, for example, you set the volume level to 85 in POS Designer, the audio in ViKING POS will by default play at 85% of its maximum possible level, which POS users can then adjust down, but not up. This means that in ViKING POS you can't set the volume of an audio file to a higher level than you've specified in POS Designer. 7. If you want to set up global audio on other components, or different events on the same component, click ![Wpud addplus circle](/_fern-files/_img/23faefcab912da74784c6594e9f743c7c3ea3b56dfbae0c8abf4a76c3c23ff7a.webp) again, and repeat steps 3-6 until you're done. > **Tip** > > If you want to add a setup that's near-identical to one that you've already set up, you can click > > ![Wpud copy audio](/_fern-files/fiftytwo.docs.buildwithfern.com/b1c3afb1807453578bf9ff3e316b88ea9880d81945a6db2efb414a86dc62f442/assets/img/help/Images-wpud-copy-audio.png) > > to copy an existing setup and modify it. 8. When you're ready, click **Save**. ### Set up audio locally on a component > **Info** > > Before you begin, make sure that you've added the required audio files to the diagram (see Add audio resources in the previous) so that you can select them in the following. 1. On the required layout, select the component that you want to set up local audio on. 2. In the **Properties** section in the right side of POS Designer, expand the component's **Basic** properties. ![Wpud component properties basic header](/_fern-files/_img/1e86f78ab2e35c1fdf08bdbee4a91bc37dd230e528a6b767ab96320de36b716a.webp) 3. In the right side of the **Audio** field, click ![Wpud component properties basic audio add1st](/_fern-files/_img/6bac6f3ee228aeccb0b5569a84c4d904bee9a313725c90a5b63b3c07babccdd2.webp) . 4\. In the **Add / edit audio** dialog that opens, click ![Wpud addplus circle](/_fern-files/_img/23faefcab912da74784c6594e9f743c7c3ea3b56dfbae0c8abf4a76c3c23ff7a.webp) . 5\. In the **Control** field, make sure that the component that you want to set up global audio on is selected. If not, select it. 6\. In the **User activity events** field, select the event(s) that should trigger the audio. 7\. In the **Select audio for each language** section, click each required language and select the audio file to use for the language in question. 8\. Below the language selection section, select the required volume level by dragging the slider to the required level (0 (min.) - 100 (max.)). ![Wpud audio adjustslider](/_fern-files/_img/d60d06264ba1d6150a2dfd9d108ca4c93a4df53a08fc3416376ac2a48b1d6406.webp) The volume level is tied to the selected events on the selected component, so if you've selected different audio files for different languages on the component, the volume level will apply for all of the languages. #### You can also adjust volume level in ViKING POS. How does my audio level selection in POS Designer affect that? The default audio level in ViKING POS is 100, so if, for example, you set the volume level to 85 in POS Designer, the audio in ViKING POS will by default play at 85% of its maximum possible level, which POS users can then adjust down, but not up. This means that in ViKING POS you can't set the volume of an audio file to a higher level than you've specified in POS Designer. 9. If you want to set up local audio on different events on the same component, click ![Wpud addplus circle](/_fern-files/_img/23faefcab912da74784c6594e9f743c7c3ea3b56dfbae0c8abf4a76c3c23ff7a.webp) again, and repeat steps 5-8 until you're done. > **Tip** > > If you want to add a setup that's near-identical to one that you've already set up, you can click > > ![Wpud copy audio](/_fern-files/fiftytwo.docs.buildwithfern.com/b1c3afb1807453578bf9ff3e316b88ea9880d81945a6db2efb414a86dc62f442/assets/img/help/Images-wpud-copy-audio.png) > > to copy an existing setup and modify it. 10. When you're ready, click **Save**. ### Global and local audio on the same component What happens if you set up audio globally on a component, and you also set up audio locally on an instance of the same component? If you set up audio globally on a component, and you also set up audio locally on a particular instance of the same component, and both setups are available in the same language, the local setup will “win” on the component with local setup, whereas the global setup will apply on all other instances of the component. Example:
ComponentEventLanguageGlobal audioLocal audioAudio used on POS
KeyboardClickEnglish*audioA.mp3**audioB.mp3**audioB.mp3* on locally set up instance of component\ *audioA.mp3* on other instances of component
*audioA.mp3*-*audioA.mp3* on all instances of component
-*audioB.mp3**audioB.mp3* on locally set up instance of component only
## Set up ability to adjust audio volume in ViKING POS In POS Designer you select a component's audio volume level when you set up the component, but users of ViKING POS typically also need to be able to adjust the volume of audio. In POS Designer there's a separate component for that purpose: 1. On the required diagram, open the layout on which you want POS users to be able to adjust audio volume. 2. In the right side of POS Designer, select **Toolbox**, and expand the **Advanced** section. 3. From the **Advanced** section, drag the **AudioVolume** component to the required position on the layout. 4. Adjust the component's properties to meet your organization's needs: * **Background color** * **Slider color:** Color of the slider handle as well as the area of the slider that has been selected by dragging the handle. * **Slider step:** Increments with which the slider handle will move when users drag it. Example: If set to 10, the slider handle will move in increments of ten (for example 0, 10, 20, etc.). * **Show thumb label:** Displays a small indicator label above the slider that informs users about the slider handle's exact position (example: 70) when they drag the slider. * **Show plus/minus buttons:** Displays plus and minus buttons that users can tap to adjust the volume as an alternative to dragging the slider. The plus/minus buttons will use the increments defined by the **Slider step** setting. 5. When you're ready, click ![Wpud layout menu save](/_fern-files/_img/a628f9e66a1f6670a694cab7339f46c66b214d0765bb7bf14db48c380730c518.webp) in the top bar to save your changes. 6\. Repeat if you want the volume adjustment component to be available on other of the diagram's layouts. When you [publish the package](/help/pos-designer/diagram) to relevant POSs, layouts on which you've added the volume adjustment component will display an audio ![Pos audioadjuster](/_fern-files/_img/1badad4c28fb1f1a4654573b889790aff61a9f7d6a9a61f2a74f9c2f94307d05.webp) icon. When POS users tap that icon, the volume adjustment slider will appear. --- Related: [ViKING POS Designer resources](/help/pos-designer/resources) Related: [Manage ViKING POS Designer languages](/help/pos-designer/resources-languages)