2012-08-13 19:03:06 -07:00
# Embed parameters
2017-09-14 13:33:27 +02:00
You can easily embed your etherpad-lite into any webpage by using iframes. You can configure the embedded pad using embed parameters.
2012-08-03 22:04:06 +02:00
2012-08-07 20:19:37 +02:00
Example:
2020-12-26 21:05:08 +00:00
Cut and paste the following code into any webpage to embed a pad. The parameters below will hide the chat and the line numbers and will auto-focus on Line 4.
2012-08-07 20:19:37 +02:00
```
2020-12-26 21:05:08 +00:00
< iframe src = 'http://pad.test.de/p/PAD_NAME #L4 ?showChat=false&showLineNumbers=false' width = 600 height = 400 ></ iframe >
2012-08-07 20:19:37 +02:00
```
2012-08-03 22:04:06 +02:00
2012-08-13 19:03:06 -07:00
## showLineNumbers
2012-08-03 22:04:06 +02:00
* Boolean
Default: true
2012-08-13 19:03:06 -07:00
## showControls
2012-08-03 22:04:06 +02:00
* Boolean
Default: true
2012-08-13 19:03:06 -07:00
## showChat
2012-08-03 22:04:06 +02:00
* Boolean
Default: true
2012-08-13 19:03:06 -07:00
## useMonospaceFont
2012-08-03 22:04:06 +02:00
* Boolean
Default: false
2012-08-13 19:03:06 -07:00
## userName
2012-08-03 22:04:06 +02:00
* String
Default: "unnamed"
Example: `userName=Etherpad%20User`
2012-10-31 16:28:12 -03:00
## userColor
* String (css hex color value)
Default: randomly chosen by pad server
Example: `userColor=%23ff9900`
2012-08-13 19:03:06 -07:00
## noColors
2012-08-03 22:04:06 +02:00
* Boolean
Default: false
2012-08-13 19:03:06 -07:00
## alwaysShowChat
2012-08-03 22:04:06 +02:00
* Boolean
2012-08-13 19:03:06 -07:00
Default: false
2012-11-14 17:21:45 +01:00
## lang
* String
Default: en
Example: `lang=ar` (translates the interface into Arabic)
2013-03-05 23:12:00 +01:00
## rtl
* Boolean
2019-10-20 02:09:22 +02:00
2013-03-05 23:12:00 +01:00
Default: true
Displays pad text from right to left.
2020-12-26 21:05:08 +00:00
## #L
* Int
Default: 0
Focuses pad at specific line number and places caret at beginning of this line
Special note: Is not a URL parameter but instead of a Hash value
2021-09-14 20:43:35 +01:00
## focusOnEditor
* Boolean
Default: true
If true, focus on the editor upon initial page load. Set this to false if the
pad is embedded in an iframe adjacent to other editable content that should
retain focus.