As a best practice use SEO-friendly URLs for Reactive Web Apps. Friendly URLs provide both humans and machines an indication of the search-engine results. With Service Center you can create the SEO-friendly versions of the URLs, manage Site Rules and Redirects. Edit custom URLs in Service Studio, in the properties of each Screen.
SEO-friendly URLs for Reactive Web Apps requires the following:
- Platform Server 11.14.0 or later
- Service Studio 11.13.0 or later
- OutSystems enterprise cloud offer or a properly configured on-premises installation
For Platform Server versions between 11.12.0 and 11.14.0 you can enable the technical preview and use Service Studio 11.11 and later.
On-premises installations must have ISAPI Filters active.
Activating and deactivating the feature
- To deactivate SEO-friendly URLs for Reactive Web Apps, remove all Site Rules from Service Center.
- After you activate or deactivate the feature, publish your apps to apply the changes.
A Site rule maps the URL to a module in the environment. If users enter
www.example.com in the browser, the platform loads the MyMainModule home screen.
The following table shows examples of Site rules:
|URL||To the module|
See Managing Site Rules for instructions.
Prioritization determines the order in which pages load in the browser. The platform uses the following priorities:
Static URLs have priority over dynamic URLs.
The priority for dynamic URLs is based on the number of parameters. Rules with fewer parameters have priority over rules with more parameters.
Custom Screen URLs
A custom Screen URL works on the module level, letting you change how the URL of one screen shows in the browser. The Screen ProductListSection from your module can load from the URL /
Products instead of
/ProductListSection. Custom Screen URLs support having the parameters on the path instead of using the query string, so you can redirect users to the URL
/Products/1 without the custom URL
The following table shows examples of custom Screen URLs:
|Original URL||With Path||With Query string|
Make sure all Page Names are unique in the environment. Otherwise, some URLs may not work. See also: Avoiding duplicated redirects.
See Managing custom Screen URLs for instructions.
Redirect rules let you redirect browser requests from the old domain or subdomain to the new URLs. OutSystems uses the 301 HTTP status code for domain-level redirects.
The following table shows examples of redirects:
|Old URL||New URL|
See Managing redirects for instructions.
Managing URL rules and redirects
The following sections provide more technical details about managing Redirects, Site Rules, and custom Screen URLs.
Managing Site Rules
To manage Site Rules you need:
- Base URL. The string to match the rule, for example
- Root Application. The module to which the platform redirects the requests, for example
Go to Service Center > Administration > SEO URLs > Site Rules List to:
- Add a Site Rule
- Update a Site Rule
- Disable or delete a Site Rule
When working with Site Rules, remember:
- You can have only one Site Rule per root application for domains with sub-paths.
- Creating or editing a Site Rule can temporarily slow down the app because the platform needs to reload the setting files.
Managing custom Screen URLs
You can add custom Screen URLs in Service Studio. Go to the properties of the Screen to which you want to set the name. Then, in the Advanced section, set the Custom URL to Yes and edit the URL structure.
If an app passes an empty string as a value for a required parameter, users see an error message. See Empty string in a required parameter causes an error for more information.
Here are more details about the properties.
|Custom URL||If you set Custom URL to Yes, Service Studio activates custom Screen URLs and lets you edit the redirect settings.|
|Page Name||The name of the page to show in the URL. Use only alphabetical characters and numbers. You can use the following special characters, but not at the beginning or at the end of the page name: "_", "-", "/" , and "~".|
|URL Structure||Set to Path to pass the parameters separated by
|URL Pattern||Preview only. Shows the URL preview as you edit the settings.|
These are the reserved strings that you cannot use in the Page Name property:
The following strings aren't supported because you can't have
/ between them:
These are additional notes about custom URLs.
- You can add custom URLs to all Screens except the Default Screen.
- When copying Screens with custom URLs from Reactive Web App module to Mobile App module, Service Studio removes the URL rules in the Mobile App module.
Managing Redirect Rules
To manage Redirect Rules you need to know the following:
- Base URL. The string to match the rule, for
- Replace With. The replacement string for the URL, for example
Go to Service Center > Administration > SEO URLs > Redirect Rules List to:
- Add a Redirect Rule
- Update a Redirect Rule
- Disable or delete a Redirect Rule
Dynamic page titles
Introduced in Platform Server 11.13.0 and Service Studio 11.12.0.
The page titles show in the browser tabs, bookmarks, and results from the search engines. Use expressions to set titles of Screens and change the page title dynamically.
OutSystems strongly recommends that all team members update Service Studio before using dynamic page titles in acollaborative environment.
To set the Screen names dynamically, do the following in Service Studio:
- Locate the Screen where you want to set the title dynamically.
- In the Screen properties, double-click the Tile property. Expression editor opens.
Enter an expression that sets the title value during runtime. For example,
"More about" + ProductTitle.