URL Parameters

What are URL Parameters?
URL Parameters allow you to accomplish the common use case of dynamic parameters in URLs, usually based on routes or user sessions. Consider the URL below.
1
https://example.com/users/2/comments?post=3
Copied!
In order to use this URL and personalize it at runtime, Mason accepts tokenized parameters prefixed by : - so the URL above would be tokenized as:
1
https://example.com/users/:userId/comments?post=:postId
Copied!
Any part of a URL string may be tokenized, and the token will be matched from : until the first non-alphanumeric character is encountered. You may use URL Parameters in form action attributes, link href attributes, and datasource URL attributes.
Providing URL Parameters
Provide a urlParams prop to your feature at runtime and keys will be substituted in all occurrences. For the URL above, you would provide the urlParams as follows
1
import React from 'react';
2
import { Canvas } from '@mason-api/react-sdk';
3
​
4
class MyFeed extends React.Component {
5
    render() {
6
        return <Canvas 
7
            id="YOUR_COMPONENT_ID"
8
            urlParams={{
9
                userId: 2,
10
                postId: 3,
11
            }}
12
        />;
13
    }
14
}
Copied!

Development - Previous

Custom event listeners

Next - Development

Handling Errors

Last modified 3yr ago

Copy link

Contents

What are URL Parameters?

Providing URL Parameters