Inserting a link into the WYSIWYG Editor

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

Considerations and caveats

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 reference everything that comes after the domain portion of a URL. 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. 

Linking 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. Refer to the article Linking to a specific location in content to find out how to do this.

How to insert a link into the WYSIWYG Editor

Copying and pasting 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 formating. 

Using the Insert Link tool

While you are creating content in the WYSIWYG Editor:

1. Click 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 clicks it.
5. Click 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, click Insert Link ().
3. Enter a URL by typing it or by performing a search and selecting the desired destination.
4. 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.
5. Select whether you want the link to open in a new tab when someone clicks it.
6. Click insert.

How to make an image a clickable link

After inserting an image into the editor:

1. Select the image to make the image editing toolbar appear.
2. On the image toolbar, click Insert Link ().
3. Enter a URL by typing it or by performing a search and selecting the desired destination.
4. Select whether you want the link to open in a new tab when someone clicks it.
5. Click insert.

How to 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 clicks 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:

How to 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.