Magic Embed
Support
Frequently asked questions about setting up Magic Embed
How can I test Magic Embed on localhost?
To test locally, your development environment must be accessible from the public internet - this allows our servers to fetch and process your page. Use a tool like ngrok or set up a Cloudflare Tunnel to expose localhost via a secure, public URL.Why is no content being extracted from my website?
Make sure you’ve followed all of the setup steps. Common reasons include:- Your domain (e.g. www.yourwebsite.com) hasn’t been added under Magic Embed settings
- Your server is blocking our request - this can happen with paywalls or bot protection
- Your account has run out of credits, in which case Magic Embed will stop importing articles
How can I exclude content that I don’t want?
You can create filters to exclude content that should not be extracted from your web page. An exclude filter will exclude certain elements, whereas an include filter will exclude everything except the specified elements.How can I include content that I do want?
It’s more difficult to force our content extractor to include specific content once it has determined that it probably isn’t part of the article. However, it sometimes helps to exclude all other content using filters (see above). Otherwise, please contact support@beyondwords.io and we will do our best to help. If you need precise, fine-grained control then it might be worth considering other options such as the RSS or API integrations.How does image extraction work?
Images are considered part of your article’s content and will also be extracted. Images will show in the Editor relative to the text content of your article and will be included in generated videos. You can use data attributes to explicitly set the feature image.Why can I see content in the dashboard but not in the player?
We automatically extract the publish date from your content by checking various metadata tags on your HTML page. If the publish date is in the future, then audio won’t be made available until that time in the player. You can add data attributes to your HTML to control publish date more precisely and set various other attributes such as the feature image.Why do I see a 404 error when loading the player?
This is normal. It means that no audio is available yet and the player has been hidden. If Magic Embed is enabled then audio generation will be triggered and load into the player once it’s ready.How long does it take for audio to load in the player?
Usually five minutes after the first visitor. The content extraction and audio generation happen more quickly but the player endpoint is cached for five minutes. We support cache invalidation on our Enterprise plans.Does audio update if I change the article text?
Yes, Magic Embed will periodically extract content from your page and check if it has changed. This only happens in response to the player being loaded on the page and is subject to rate limits to avoid lots of requests.How do I avoid generating audio for old articles?
The simplest approach is to only embed the player on articles published after a certain date. You can check the publish date of your article and conditionally include the player embed code only for newer content. Alternatively, you can setclientSideEnabled: false when initializing the player if the publish date of your article is before some cut-off date.