Last updated

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:

Add a remote URL source

To add content from a remote file:

  1. In the Editor, select + > New remote > Add URL link.
  2. Enter the URL of the publicly-available file to include in the project.
  3. Enter the filename for this file in the Redocly project.
  4. Select the appropriate Sync frequency, between 15 minutes and 12 hours. Files that update infrequently can be synced less often.
  5. Select the Auto-sync or Auto-merge toggles to turn off either option.
  6. Enter a name for the destination of the remote content in the Mount folder path text box.
  7. Select Next. 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.

  1. Refresh your browser to see a View Pull Request button next to your new branch name.
  2. Select View Pull Request.
  3. Review your updates in the Review tab.
  4. 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