What's inside this article:
- Basic information
- Retrieve embed code or URL
- Embed on a content page
- Embed on an HTML widget
- Check requirements
- Request a new allowed external media item
Basic information
This article explains how to embed an allowed external media item.
You might embed an allowed external media item as follows:
Retrieve embed code or URL
First, you need to retrieve the embed code / URL for the external media item from the third-party platform. In most cases, you need an embed code. However, in some cases it is also possible to use a URL. You can check the requirements from Pangea CMS. For details, go to the following section:
To embed a YouTube Short with vertical orientation, you need to use the URL (not the embed code). For details, see the following article:
Below, find links to external support articles that explain how to retrieve the embed code for some of the most commonly used external media items:
Datawrapper Academy
Facebook Help Center
- How do I embed a Facebook post I've shared onto a website?
- How do I embed a video from Facebook onto a website?
Flourish Help Center
Embedding your project on a web page
Instagram Help Center
What are Embeds on Instagram and how can I embed an Instagram post or profile?
Telegram
X Help Center
YouTube Help
Embed on a content page
You can embed an allowed external media item into the body of the following text content pages:
- Article
- Blog
- FactCheck (embed in the Verdict content)
- Feature
- Feature story
- Live blog (embed in a post)
- News
- Transcript
To learn how to create these content pages from the beginning, see the following articles:
- Create a text content page
- Create a FactCheck page
- Create a Feature story page
- Create a Live blog page
To embed an allowed external media item from the edit screen for a text content page:
- Via Editor, click inside the main box to reveal the CKEditor bar. Position the cursor where you want to insert the item.
- Hit the Insert Embedded Content button in CKEditor.
- Select External media.
- Under External media URL or embed code, paste the embed code / URL.
- Under Personal note, optionally enter a note. Personal notes are displayed only in Pangea CMS (not on the public site). The purpose is to let other CMS users verify what has been embedded.
- Hit Attach.
You see a placeholder representing the embedded item in CKEditor. If you added a personal note, the note is displayed on the placeholder.
To check exactly how the embedded item will look on the published page, use the options under Preview in the left panel.
Embed on an HTML widget
You can embed an allowed external media item on an HTML widget. This lets you display the item on any of the following pages / segments:
- Section pages (including your homepage)
- Infopages
- Landings
- Regions
- You Might Also Like (YMAL)
To embed an external media item on an HTML widget:
- Select Build in the primary navigation.
- Choose the type of page / segment where you want to display the external media item.
- Select the specific page / segment where you want to display the external media item.
- Ensure Editor is selected in the left panel.
- Select the empty area where you want to display the widget.
- Select New widget > HTML to start building a new HTML widget.
- In the Content section, hit the Insert embedded content button.
- Follow steps 3-6 under Embed on a content page.
The remaining steps are the same as for creating a standard HTML widget. For instructions, see the following article:
Check requirements
From the External media tab, you can check the requirements for each allowed embed. In most cases, you need an embed code. However, in some cases it is also possible to use a URL.
For each item, hover over the ? to see what is required to embed this item (embed code or sharing URL).
Request a new allowed external media item
If the item you want to embed is not included on the list of allowed external media, you can contact Pangea Customer Care to request that a new item is added to the list. Before making a request, review the conditions below:
- An allowed item needs to offer long-term value for multiple Pangea sites.
- We do not approve requests that are connected to one-off projects.
If you need a particular embed for a one-off project, we suggest that your site creates the embed as a Snippet / Dynamic infographic instead.
