Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


This page contains instructions on how to manage and add new custom buttons to the interface.

Table of Contents


VoipNow allows you to customize the functionality of the web management interface with the help of custom buttons that are linked to specific URLs. To reach the Custom Buttons management page, go to Unified Communications in the left menu and click on the Custom Buttons icon under the Integrations area.

Add new custom button

To add a new button:

  1. Click the Add Custom Button icon and define the Settings of the new button.

    titleClick here to expand the settings.

    CodeEnter a unique reference code which will represent this button's key. Must be at least 3-character long. Objects with a unique reference code can be edited based upon this ID.
    LabelEnter the button tag and click it to access the specified location.

    Choose the location of the new custom button using the radio buttons: Navigation panel - Gets displayed on the left panel, in the navigation panel. User's context - Gets displayed on the right panel, in the user's context.

    Default image for all skinsDisplays the new custom button in all available skins using the default button icon. If you wish to load custom icons, deselect this checkbox and follow these instructions.
    Include service provider IDAppends the ID of the currently selected service provider to the URL linked with the button.
    Include organization IDAppends the ID of the currently selected organization to the URL linked with the button.
    Include user IDAppends the ID of the currently selected user to the URL linked with the button.
    Include extension ID Appends the ID of the currently selected extension to the URL linked with the button.
    Include extension internal numberAppends the internal number of the currently selected extension to the URL linked with the button.
    Include extension public numberAppends the public phone number of the currently selected extension to the URL linked with the button.
    Include charging planAppends the ID of the currently selected user to the URL linked with the button.
    PriorityDefines the order in which the custom buttons are displayed in the interface.
    URLThe URL that will open when you click this button.
    Tool tipA short text describing the purpose of the button.
    Display method

    Choose one of the two methods by selecting the appropriate radio button: Inheritance level or Account selection. The main difference between the Inheritance level and the Account selection methods lies in the visibility of the button.

    If you choose the first option, the button will only be visible to the specified level, without having to be available to all the other upper levels.

    Inheritance level

    Specify the button visibility relative to the current account.

    e.g. A service provider account owner setting up a button inheritance level to 1, makes it available to it's subordinate organization accounts, but not to its user accounts.
    Display on account/extension

    Specify the button visibility relative to the a certain account level. The button will be visualized by your selected account level and by its parent accounts.

    • Service Provider - visible only in the service provider accounts context.
    • Organization - visible only in the organization accounts context.
    • User - visible only in the user accounts context.
    Also display on owner accountThe button will be visible to its owner account and to the organization and user accounts. The Also display on owner account option is not available unless the Display method is b.
    ActionSpecify if the URL will open in the current window or a new window using the radio buttons.

  2. Define the Custom button expiration date. Specify when the custom button becomes invalid by deselecting the Unlimited checkbox and providing a date using the text box or the available calendar button.
  3. Click OK to confirm settings and create button. Click Cancel to go back to the previous page without adding the button to the system.

To edit an existing button, apply the same steps as above.

Add custom image file

If you deselect the Default Image for All Skins icon, VoipNow will display additional controls:

  1. Use the Browse button to locate a graphic file on your computer.
  2. Select the checkbox corresponding to the skin where you want the icon to be used. If you want to use the same icon for all the VoipNow skins installed on the server, you need to select the All skins checkbox.

  3. Use the +/- buttons to add icons for different skins at the same time. The maximum file size for an icon is 10 KB.

Enable or disable a button

VoipNow displays all custom buttons added to the system in the Custom Buttons table. To enable or disable a specific button, simply click on the S (Status) icon, which shows the status of the sound: for enabled for disabled

Search for a button

You can filter the Custom Buttons table by label:

  1. Enter the label of the button in the text box at the top of the table.
  2. Click the  Search button. The system will remember the search criteria when a new search is performed and even after the user logs out.

Remove a button

To remove a button:

  1. Select the custom button from the table and click the Remove selected link on top of the table.
  2. Select the Confirm removal checkbox and click OK. To return to the previous page without removing the button, click Cancel.

NameRelated topics

Manage skins



Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 4.0 International.