Skip to content

Latest commit

 

History

History
36 lines (22 loc) · 2.37 KB

catalog-urls-dynamic-media.md

File metadata and controls

36 lines (22 loc) · 2.37 KB
Raw
title group redirect to
Dynamic Media URLs
marketing

A dynamic media URL is a relative reference to an image or other media asset. When enabled, dynamic media URLs can be used to link directly to assets on your server, or to files stored on a [content delivery network]({% link system/media-storage-content-delivery-network.md %}). The use of dynamic media URLs can impact catalog performance, and the [editor]({% link cms/editor-configure.md %}) can be configured to use either static or dynamic media URLs.

As with all [markup tags]({% link marketing/markup-tags.md %}), the directive is enclosed in double curly braces. The format of a dynamic media URL looks like this:

{% raw %}{{media url="path/to/image.jpg"}}{% endraw %}

Dynamic URL directives are processed from saved HTML content when the page is rendered on the storefront. Each time the page is rendered, the content is scanned for {% raw %}{{media url="..."}}{% endraw %} and each directive is replaced with the corresponding media URL.

{% include directives-caution.md %}

Configure static media URLs

By default, images inserted into the catalog from the WYSIWYG editor have relative, dynamic URLs. If you prefer to use a static URL, you can change the configuration setting.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel under General, choose Content Management.

  3. Expand ![]({% link images/images/btn-expand.png %}) the WYSIWYG Options section.

    ![]({% link images/images/config-general-content-management-wysiwyg-options.png %}){: .zoom} [WYSIWYG Options]({% link configuration/general/content-management.md %})

  4. Set Use Static URLs for Media Content in WYSIWYG to one of the following:

    | Yes | Uses static URLs for media content that is inserted with the WYSIWYG editor. Static URLs are absolute and break if the [base URL]({% link stores/store-urls.md %}) of the store changes. | | No | (Default) Uses dynamic URLs for media content that is inserted with the WYSIWYG editor, based on the {% raw %}{{media url="..."}}{% endraw %} directive. Dynamic URLs are relative and do not break if the [base URL]({% link stores/store-urls.md %}) of the store changes. |

  5. When complete, click Save Config.