➕ How to insert a shared element?

👋 Introduction


You’ve created shared elements in the library? Perfect! Now, learn how to easily insert them into your articles, guides, FAQs, and other Mayday content.

You can insert a shared element in three ways:

1. Direct Method → @


gif___rhxgjbidurawdpib.gif

  1. Place your cursor at the desired location

  2. Type "@" followed directly by the name of the shared element

    • Example: @Return Policy

  3. Select the shared element from the list that appears

  4. Confirm by clicking or pressing Enter

2. Through the Menu → /


gif_gif___s3ekfxpua5rya7oo.gif

  1. Place your cursor at the desired location

  2. Type "/" to open the block menu

  3. Select "Shared Element" from the menu

  4. Type the name of the shared element you’re looking for

  5. Select and confirm

3. By using the URL


gif_url___tkiyawfqpefyuise.gif

  1. Place your cursor on the desired location

  2. Paste the URL of the shared content

  3. Click on the URL and then on the button “Switch to shared element

Best Practices for Insertion


Insert a shared element when:

  • The information is identical across several contents

  • The information is likely to change regularly

  • You want to ensure consistency of information

Avoid using a shared element when:

  • The information is specific to a single article

  • The context requires local adaptation of the content

  • You need a customized variant of the information

Insertion Context

  • Check for flow consistency

  • Add a transition if necessary

  • Never manually duplicate content

🌍 Multilingualism


Insert the correct language version based on your article’s language. The different versions of your shared elements can be found through the title used in each language.
The language of the shared element is indicated by a flag during selection.

Note of caution

Mayday does not restrict you from inserting a shared element in a different language. Verify manually the language during insertion.

Learn more, check out the dedicated article

🔍 Finding a Shared Element


If you don’t know the exact name of the shared element you are searching for:

  1. Use the search bar to find the shared element by keywords

  2. Filter by "Shared Element" to refine the results

  3. Check the collections to explore shared elements by theme

Once the correct shared element is identified, note its title and use @ or / to insert it!


You now know how to insert your shared elements wherever you need them! 🚀

Learn more, consult the documentation dedicated to shared elements:

Did this article help you?

Contact us