Inserting a link into the WYSIWYG editor

Use the WYSIWYG editor to include links to important resources in your content.

Sections in this article:

Who can do this?

  • Enterprise administrators
  • Workplace administrators
  • Space administrators
  • Members of the digital workplace with Write, Edit or Full access

Valid URLs

URLs that you enter for a link must use one of these URI schemes:

  • http
  • https
  • file
  • ftp
  • ftps
  • mailto
  • mms
  • rdp
  • rtsp
  • smb

Other URI schemes are not supported and will not function as links.

Relative vs. absolute URLs when linking to other locations in your workplace

When linking to other locations in your digital workplace, you should use relative links. Formatting your links this way prevents future broken links from occurring if the domain of your digital workplace changes. If you are linking to content outside of your digital workplace, you must use an absolute URL.

Relative URLs refer to everything after the domain portion of a URL. For example, the relative URL of the location below would be /community/community_discussions.

https://customercare.igloosoftware.com/community/community_discussions

Redirects

Sometimes the content that you link to in your digital workplace gets moved to a new location. Your workplace will keep track of these changes to ensure that your original link still ends up at the intended location by redirecting it. If the content you are linking to is outside of your digital workplace, you may need to update the link of the external source if it does not have a method of handling redirects. 

Link to a specific location in content

You can create links to specific locations of content; however, it requires setting up identifiers for the locations that you want to link to. See Linking to a specific location in content.

Insert a link into the WYSIWYG editor

Copy and paste a URL

You can copy and paste an existing link or URL from another location into the editor. The editor will recognize that this copied text is a link and apply the correct formatting. 

Use the Insert Link tool

While you are creating content in the WYSIWYG editor:

  1. Select  Insert Link.
  2. Enter a URL by typing it or by performing a search and selecting the desired destination.
  3. Enter a description of the linked destination. This text will display in the editor instead of the URL.
  4. Select whether you want the link to open in a new tab when someone selects it.
  5. Select Insert.

Using the Insert Link tool with text selected

While you are creating content in the WYSIWYG editor:

  1. Select the text that you want to turn into a link.
  2. With the text still selected, select  Insert Link.
  3. Configure the following:
    • URL: Enter a URL by typing or pasting it. Alternatively, use the search box above URL to locate the desired destination.
    • Text: The text description field defaults to the selected text that you have selected. You can change this by entering a new description, but this also changes the selected text.
    • Open in new tab: Select the checkbox to open then link in a new tab when someone selects it.
  4. Select Insert.

Make an image a link

After inserting an image into the editor:

  1. In the WYSIWYG editor, select the image to make the image editing toolbar appear.
  2. On the image toolbar, select  Insert Link.
  3. Configure the following: 
    • URL: Enter a URL by typing or pasting it. Alternatively, use the search box above URL to locate the desired destination.
    • Open in new tab: Select the checkbox to open then link in a new tab when someone selects it.
  4. Select Insert.

Autofill sections of an email when using mailto links

You can insert mailto links into your content in the same way that you would create a link to a URL. However, instead of entering a URL to go to, you enter mailto: followed by an email. When a user selects this link, their default email application opens with the To field pre-populated with the mailto email. You can also pre-populate other email fields when using a mailto link by appending additional parameters to it. The first additional parameter must begin with a ? and subsequent parameters must begin with &. Additional parameters include:

  • cc={followed by an email or comma-separated list of emails to include as CCs
  • bcc={followed by an email or comma-separated list of emails as BCCs}
  • subject={followed by text to include in the subject line of an email}
  • body={followed by text to include in the subject line of an email}

For example, a mailto link that prepopulates the subject and body fields would look like this:

mailto:name@youremaildomain.com?subject=Feedback&body=See below:

Edit links

Link editing tools

Selecting a link while editing content in the WYSIWYG editor displays a toolbar with the following editing tools:

Action
Usage

Edit Link

 Change the URL, description text, or tab opening behavior of a link.

Unlink

 Remove the link, but keep the description text.
WYSIWYG tools