Add remote content from a URL
Use the remote content feature to include content from external sources in your project. This approach is useful for including a single, publicly-available file as part of your published project.
Before you begin
Make sure you have the following before you begin:
- latest version of Realm
- an existing Redocly project to add remote content to
Add a remote URL source
To add content from a remote file:
- In the file tree, select the folder (or click on the empty space to select the root directory) to which you want to add the remote content folder.
- Select + > New remote folder > Add URL link.
- Enter name for the new remote content folder and press Enter or Return key.
- Enter the URL of the publicly-available file to include in the project.
- Enter the filename for this file in the Redocly project.
- Select the appropriate Sync frequency, between 15 minutes and 12 hours. Files that update infrequently can be synced less often.
- Select the Auto-sync or Auto-merge toggles to turn off either option.
- Select Add remote. This action opens a pull request in Redocly automatically. After refreshing your browser, you should see a View Pull Request button next to your new branch name.
Merge the open pull request in Redocly
After you enter the connection details in Redocly, a pull request to merge your updates with the default branch opens.
- Refresh your browser to see a View Pull Request button next to your new branch name.
- Select View Pull Request.
- Review your updates in the Review tab.
- After the tests have run and your pull request has been approved, click the Merge button to merge your updates with the default branch.
Resources
- See guides for adding other types of remote content
- Learn more about remote content