Portal guides
Looking for Realm documentation? These documentation are for our old developer portal. Realm users should contact their account manager for details of the early access documentation.
Learn how to work with the Developer portal.
Portal management
Organize files
How to organize your portal content
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Update the portal
How to upgrade the Developer portal to the latest version
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Integrate Reference docs
How to integrate API reference docs into your portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Use the API catalog
How to integrate files from Redocly API registry into your portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Embed the portal into a website
How to use a proxy to embed the Developer portal into a website
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Restart portal builds
How to restart a Developer portal build in Workflows
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Portal content
Supported Markdown features
List of special Markdown features supported in the portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Reuse content
How to reuse and single-source content with Markdown snippets
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Insert Mermaid diagrams
How to add Mermaid diagrams to your pages
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Create step-by-step guides
How to create interactive API guides
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Set up portal redirects
How to set up 301 redirects in your portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Customize response headers
How to configure custom response headers for hosted portals
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Document microservices
How to document microservices APIs with the Developer portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Customization
Customize portal navigation
How to customize portal navbars and footers
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Configure environment variables
How to use environment variables in the portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Built-in environment variables
List of built-in environment variables
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Environment variable files
How to create environment variable files
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Add the table of contents
How to add a table of contents to a page
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Custom 404 page
How to create a custom 404 page for your portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)
Reference hooks
How to use hooks in Reference docs integrated into the portal
![](/assets/arrow.466cdbfdf40f0641bc812f8d07fca87536fa6f035815c0c0c6ac80406a245158.33dfd5cc.png)