Skip to content

Embeds

There are a few ways to add embeds to body text. A tweet you paste in. On the Embed menu (under the mountain-range icon), there's Video for videos and Responsive Embed for socials and other stuff.

Here is the Embeds menu:

HTML Embed

You can do an HTML Embed in Grove, but it's not a common use case and it's not at all graceful. Let us know in #grove-community if you do this. Much of what you used HTML Embed for in Seamus, however, is done via Responsive Embed in Grove.

Responsive Embed

A Responsive Embed does some of what HTML Embed did in Seamus. It's not for custom HTML, though — just for embedding stuff. "Responsive" means "gets bigger or smaller to fit the window/device." Instagram, Spotify, TikTok and Threads are all Responsive Embeds. DocumentCloud, too, though we don't have updated Grove direx for that yet. Twitter can be done this way as well.

To add one:

  1. Get the embed code — NOT the link — of the item. Usually this can be had by clicking the Share icon, often a curled arrow or a paper airplane.
  2. Choose Responsive Embed from the embed menu (mountain-range icon).
  3. Click the magnifying glass.
  4. Click NEW RESPONSIVE EMBED button.
  5. Give it a name — this won't be seen anywhere but in Grove.
  6. Paste the embed code where it says Full Html Embed.

It will look something like this:

  1. If you know you're supposed to set it to Do Not Syndicate? then toggle that to blue.
  2. Click PUBLISH. This does not publish the story — just the embed.
  3. Click < Back.
  4. Click on the embed — it's at the top of the flyout pane.
  5. Click SAVE & CLOSE.

Tweet

To add a tweet, get the link to the tweet. Paste it into the body. You can also use URL Embed on the Embed menu, or get the tweet's embed code and follow the instructions for Responsive Embed above. All of it should work.

YouTube

There are regular YouTube videos, live ones and Reels. There are Known Issues with how the titles and credits display. They are ticketed.

Regular

To add a YouTube video, choose Video in the embeds menu (mountain-range icon).

  1. Click the magnifying glass.
  2. Click NEW VIDEO in the lower left.
  3. Choose YouTube (URL) from the Provider menu.
  4. Paste in the URL under YouTube URL or ID.
  5. Fill in fields as needed. Some will auto-populate. Some you may not need/want.
  6. To add a custom thumbnail, go to the Thumbnail tab and do so.
  7. Click the green PUBLISH button.
  8. Click < Back.
  9. Click the video name at the top of the flyout pane.
  10. To the video in the margin with text wrap, choose Medium from the Size dropdown. If you want it the width of the text, leave it alone. If you want it huge, choose Extra Large.
  11. Click the SAVE & CLOSE button.

NOTE: If at any point it asks you for Metadata, just continue on your way. If it won't let you continue, give it a duration of a millisecond and move on: 00:00:00:001

Live

To add a LIVE YouTube video, you need to get its embed code and make a Responsive Embed as detailed under Responsive Embed, above.

Reel

  1. If the Reel doesn't have embed code in the Share button, get the URL and replace "shorts" with "embed."
  2. Take that URL and paste it into this code:

<div style="max-width: 400px; margin-left: auto; margin-right: auto;"> <iframe width="419" height="744" src="URL" title="TITLE" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </div>

  1. Add a title as well.
  2. Paste into a Responsive Embed.

If the Reel does have embed code, put it between the divs above and make a Responsive Embed.

NPR Video

To add a JW Player video, choose Video in the embeds menu (mountain-range icon).

  1. Click the magnifying glass.
  2. Click NEW VIDEO in the lower left.
  3. Fill in Video Title.
  4. Choose NPR Video in the Provider dropdown menu.
  5. In JW Player, click the Assets tab for your video. Copy the HLS Manifest.
  6. Paste in the HLS URL path in Grove.
  7. Add Caption if you want.
  8. Enter in the video duration, credit and source in the appropriate fields.
  9. To add a custom thumbnail (because you don't like the one that's auto-generated) go to the Thumbnail tab and do so.
  10. Click the green PUBLISH button.
  11. Click < Back.
  12. Click the video name at the top of the flyout window.
  13. To add a caption, type it in the Caption field.
  14. To display the video in the margin with text wrap, choose Medium from the Size dropdown. If you want it the width of the text, leave it alone. If you want it huge, choose Extra Large.
  15. Click the SAVE & CLOSE button.

NOTE: If at any point it asks you for Metadata, just continue on your way.

MP4 Video

You can't add video files from your computer to Grove. Tell #dm-dmco-support what you need, and they will provide a JW Player embed code.

Containers

The equivalent to a Seamus container is the Rich Text module. Here's how to add one:

  1. Make sure you already have text. To wrap text around a container, the text has to be there first.
  2. Click into the embeds menu (mountain-range icon).
  3. Choose Module.
  4. Choose Rich Text (using the drop-down that says Ad).
  5. Add your elements — text, images, Promo Links, whatever you need to contain. You'll do this just like you're editing body text anywhere else.
  6. If you want the module in the margin, choose Right Alignment under Enhancement Alignment under Enhancement Styles.