Adding links to emails in the Design Editor

You can add a link to the following content components:

You can link to:

  • A landing page
  • A file in file storage
  • An external webpage
  • A system action like subscribing to an email group or opening the subscription management page
  • A new email message

Learn more by watching this video!

Tip: Getting an invalid URL error for a blind form submit link could mean that you're using the wrong URL syntax; the email editors now use tilde syntax. See Creating blind form submit links for more information.

Note: With the 24C release, on August 3rd, 2024 (Pods 1, 2, and 7) and on August 17th (Pods 3, 4, 6, and 8), all links will automatically include the authentication hash parameter. The authentication hash is added to links in emails at email send time and to links in landing pages at page load time. For emails sent after the 24C release, the authentication hash parameter will be added to links within the email and enforced for redirect links. Any alterations will result in redirect links being blocked. Please note that Emails sent prior to 24C release will not include the authentication hash parameter in any links within the email. However, redirect links will continue to work until Eloqua enforces the authentication hash parameter on previously sent emails beginning on January 15th, 2025. This means that, on January 15th, 2025, any emails sent prior to the 24C release and are in a recipient's inbox that contain redirect links will be blocked due to not having the authentication hash parameter. Read the product notice.

Adding links to text content

To add a link to a text content component:

  1. Add the text content to your email.
  2. After adding the copy to the text content component, highlight the text that you want to make a link.
  3. Click An image of the link icon.

    The Hyperlink panel opens.

  4. Add the link details to the Hyperlink panel.

Adding links to images

To add a link to an image:

  1. Add the image content to your email and add the image.
  2. Click the image content component and add the link using the Hyperlink Properties in the Image panel.

Adding links to buttons

To add a link to a button:

  1. Add the button content to your email.
  2. Click the button content component and add the link using the Hyperlink Properties in the Button panel.

Warning: To avoid issues with buttons rendering in your emails, do not copy and paste text which contains hyperlinks into your buttons.

Link types

The following table describes the types of links you can add to an email.

Type Description

Landing Page

Link to an existing landing page in the application. The landing pages that you can link to are available from the hyperlink library. Learn more about the Component Library.

Links to landing pages are tracked by default.

File in File Storage

Link to a file that has been uploaded to the file storage, such as a PDF file. Learn more about  Component Library.

Links to files in file storage are tracked by default.

Webpage

Link to an external web page. These types of links can include field merges.

Use the Add tracking for untracked external pages or the Redirect for untracked pages check box to enable tracking on an otherwise untracked website. See Tracking links to external websites for more information about external link tracking.

Note: Oracle Eloqua landing pages are tracked by default, no action is required to track landing pages. If a landing page URL is detected when adding a webpage link, the tracking option will be disabled and the URL link will not be displayed in manage links.

System Action

Link to subscription management or email viewing options. Often these links are included in the email header or footer, but can be included in the body of the email as well.

System action links are not tracked.

The following system actions are available:

  • Add to Email Group: Allows the recipient to subscribe to the email group for the current email.
  • Remove from Email Group: Allows the recipient to unsubscribe from the email group for the current email.
  • Send to Subscription List: Sends the recipient to the Oracle Eloqua Subscription Management Page where they can manage all their email group subscriptions as well as globally opt-in or opt-out of emails from your organization. Learn more about the Subscription Management Page.
  • Send to Subscription Page: Sends the recipient to a page that communicates their subscription status for the email group for the current email.
  • Subscribe to All: Allows the recipient to globally subscribe to all emails.
  • Unsubscribe from All: Allows the recipient to globally unsubscribe from all emails.
  • View online version: Allows the recipient to open the email in a web browser instead.

Note: If you use Eloqua's unsubscribe system action link, and are not sending contacts to a subscription management page, we recommend that you setup an intermediate unsubscribe page. This is a landing page created in Eloqua using a template we provide. When a contact clicks an unsubscribe link, they are presented this page to confirm the unsubscribe. If you do not use this type of landing page, contacts can be unsubscribed by email scanning tools unintentionally. To enable the intermediate unsubscribe page, update your email defaults.

New Email Message

Creates a link that when clicked will open a new email message in the visitor's default email program. This is a also called a mailto link.

This is not available in Oracle Guided Campaigns.

Learn more

Working with email content components and layouts in the Design Editor