Spaces
/
URL Parameters
Menu
Getting Started
What is Internal?
Connecting to Data Sources
Glossary
Tutorials
Tool Tutorial: Client Onboarding
Tool Tutorial: Approval Queue
Tool Tutorial: Customer Support
Datasources
BigQuery
Cassandra
Cloud Firestore
DynamoDB
Google Sheets
HTTP Data Source
Hubspot
MongoDB
MySQL
PostgreSQL
S3
SQL Server
Salesforce
Stripe
Zendesk
Functions
Introduction to Functions
MongoDB Functions
SQL Functions
HTTP Functions
Dynamic Parameters
Filter, Sort, Pagination (Reserved Parameters)
Spaces
Binary Data
Introduction to Spaces
Auto-generated Spaces
Creating and Publishing Spaces
Environments
Field Configuration
Data Display Options
Current User
URL Parameters
Visibility Rules
Components
Introduction to components
Bulk Import
Button
Card List
Chart
Detail
Dropdown
Form
Image
Input
JSON Viewer
Link
Pop-up Form
S3 Uploader
Table
Text
Settings
Users
Permissioned Data Flows
Managing Data Sources
Security
Auth Providers
Custom Authentication

URL Parameters

A URL Parameter can be added to any Space, making it available for components in the Space to utilize. This can be useful if you want to create a Space that shows data tied to a specific parameter.

‍

Example Use Cases:

Jane created two Spaces: “All Companies” (displays a list of Jane’s customers) and “Company Profile” (displays detailed information for a specified company). In All Companies, when a user selects a specific company (let’s say with company_id=123), they should be taken to the Company Profile for company_id= 123.

‍

How to add URL Parameters

‍

  1. Click the App Data icon on the left nav.
  2. Click “+” next to URL Parameters.
  3. Enter your URL Parameter.

Note: URL Parameter should only include 0-9, letters A-Z & a-z, "-", ".", and "_".

‍

‍

Utilizing URL Parameters

A URL Parameter can be used to filter data displayed in components like Table, Detail, or Card List. For example, you may want to display all records in a Table where the column "id" is equal to the URL Parameter "company_id" that is passed into your Space.

  1. Open the configuration settings of your component.
  2. Click on the “Filters” tab.
  3. Add a new filter and bind to the URL Parameter you created.  

‍

‍

‍

Table config (Filters)

A URL Parameter can also be used to populate components like Form, Button, Calculated Fields, and JSON Viewer. For example, you may want to pre-fill a form's input field "Id" with the value of the URL Parameter "company_id" that is passed into your Space.

  1. Open the configuration settings of your component.
  2. Click on the “Fields” tab.
  3. Select a field that you want to bind to the URL Parameter.
  4. In “What value should be used?”, choose “Use a value from a Component” and select the URL Parameter.

‍

‍

‍

‍

‍

‍

Form config (Fields)

Link two spaces together with URL Parameters

URL Parameters are a great way to add contextual linking between Spaces. Once you've added a URL Parameter to a Space (Space A), go to another Space (Space B) and try adding a Link component. The Link template should include your URL parameter.

For example, https://secure.internal.io/spaces/A?company_id=1234 would send a user to Space "A" where the URL Parameter "company_id" is equal to 1234.

Learn more about the Link Component.

‍