Upcoming Changes to Design Studio URLs

[#1]

In 2021, Marketo Engage will be making changes to the URL structure for Landing Pages, Forms, and Images & Files assets.

Why is this change being made?

Technical Details

Landing Pages

Images & Files

Forms

What customer action is required?

When is this change being made?

Starting January 21, 2021, we will begin gradually provisioning new Marketo Engage subscriptions with the new URL structure. On March 5, 2021, all new Marketo Engage subscriptions will be provisioned with the new URL structure in place.

For existing Marketo Engage subscriptions, we will begin gradually rolling this change out beginning April 1, 2021. More details on our rollout timeline will be released in March, 2021.

Why is this change being made?

When a Marketo Engage subscription is not configured with a branded CNAME, Design Studio assets use a common hostname shared among all customers on the same pod. This behavior can be exploited in a phishing attack where a user cannot be sure a link to a Marketo Engage hosted asset belongs to the business they expect it to belong to. By updating each instance to use its own unique hostname, it is clearer to users the destination of URLs they are accessing.

Technical Details

Landing Pages, Form embed code, and resources stored in Images & Files will have URLs updated from a hostname shared among all subscriptions on the pod to a hostname unique to each Marketo Engage subscription. Subscriptions configured to use a custom CNAME for their landing pages will be minimally affected by this change.

Landing Pages

Subscriptions without a configured landing page domain

Landing page paths will change to a unique hostname for your subscription.

Before: http://na-sj01.marketo.com/lp/123-ABC-456/unsubscribePage.html

After: http://123-ABC-456.mktoweb.com/lp/123-ABC-456/unsubscribePage.html

Subscriptions with a configured landing page domain

Landing pages will continue to load from your configured landing page domain. No changes will be made.

Before: http://example.marketo.com/unsubscribePage.html

After: http://example.marketo.com/unsubscribePage.html

Images & Files

Subscriptions without a configured landing page domain

Paths to resources stored in Images & Files will change to a unique hostname for your subscription.

Before: http://na-sj01.marketo.com/rs/123-ABC-456/images/cuteKitten.png

After: http://123-ABC-456.mktoweb.com/rs/123-ABC-456/images/cuteKitten.png

Subscriptions with a configured landing page domain

Resources stored in Images & Files will continue to load from your configured landing page domain. No changes will be made.

Before: http://example.marketo.com/rs/123-ABC-456/images/cuteKitten.png

After: http://example.marketo.com/rs/123-ABC-456/images/cuteKitten.png

Forms

Subscriptions without a configured landing page domain OR subscriptions without landing pages secured by SSL

Before:

<script src="//app-sj01.marketo.com/js/forms2/js/forms2.min.js"></script>
<form id="mktoForm_1"></form>
<script>MktoForms2.loadForm("//app-sj01.marketo.com", "123-ABC-456", 1);</script>

After:

<script src="//123-ABC-456.mktoweb.com/js/forms2/js/forms2.min.js"></script>
<form id="mktoForm_1"></form>
<script>MktoForms2.loadForm("//123-ABC-456.mktoweb.com", "123-ABC-456", 1);</script>

Subscriptions with a configured landing page domain secured by SSL

In our October 2020 release, we updated our form embed code to load from the landing page domain when it is secured by SSL. No further changes will be made.

Before:

<script src="//example.marketo.com/js/forms2/js/forms2.min.js"></script>
<form id="mktoForm_1"></form>
<script>MktoForms2.loadForm("//example.marketo.com", "123-ABC-456", 1);</script>

After:

<script src="//example.marketo.com/js/forms2/js/forms2.min.js"></script>
<form id="mktoForm_1"></form>
<script>MktoForms2.loadForm("//example.marketo.com", "123-ABC-456", 1);</script>

What customer action is required?

Marketo Engage subscriptions provisioned after March 5, 2021 will have the new URL structure already in place for all Design Studio assets.

Existing Marketo Engage subscriptions will be migrated in a staggered rollout to the new URL structure during nightly maintenance cycles. There will be no downtime, but landing pages may experience a short period of degraded performance during migration.

Existing URLs and references will continue to work after the migration to the new URL structure. However, in 2022, we will deprecate the old URLs structure in use today. More details on our deprecation timeline will be provided in March 2021.

To begin preparing for this change, we suggest doing the following:

• Configure your Landing Page URLs with a CNAME https://docs.marketo.com/display/public/DOCS/Customize+Your+Landing+Page+URLs+with+a+CNAME
• Secure your Landing Pages with SSL https://docs.marketo.com/display/public/DOCS/Add+SSL+to+Your+Landing+Pages
• Begin updating pages where you embed Marketo Engage forms with the new embed code introduced in our October 2020 release (requires secured landing pages)
• Begin an audit of where you reference Design Studio assets on the web. This will help you begin a plan to update any existing references to our older URL structure before we begin deprecation in 2022. Generally this will be on non-Marketo pages, as our Landing Page editor will automatically format embedded images and forms in a compatible manner.
  • Only references hardcoded to the old URL structure need to be updated, e.g.  http://na-sj01.marketo.com/rs/123-ABC-456/images/cuteKitten.png. Relative references will continue to work without need changes e.g.  /rs/123-ABC-456/images/cuteKitten.png. Please work with your web developer to determine where you may need to make updates.