Skip to content

Commit 48d5300

Browse files
Merge pull request #5519 from JayaShakthi97/input-format
Update attribute input formats doc
2 parents c0f1020 + 77a283e commit 48d5300

File tree

7 files changed

+19
-6
lines changed

7 files changed

+19
-6
lines changed
44.4 KB
Loading
63.5 KB
Loading
200 KB
Loading
44.4 KB
Loading
63.5 KB
Loading
200 KB
Loading

en/includes/guides/users/attributes/manage-attributes.md

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -189,7 +189,7 @@ To configure properties of user attributes:
189189
!!! Danger "Warning"
190190
These settings only control how the attributes behave in WSO2-managed UIs (Administrator Console, End-User Profile (i.e. My Account), Self-Registration). They **do not** affect backend or API validation.
191191

192-
If you create a custom end-user profile UI, you can reference these configurations to apply the same rules (Display, Required, Read-only) in your own forms.
192+
If you create a custom end-user profile UI, you can reference these configurations to apply the same rules (Display, Required, Read-only) in your own forms.
193193

194194
!!! note
195195
Using the attribute configurations, you can also configure which attributes are displayed in the user creation form when
@@ -230,7 +230,7 @@ To configure properties of user attributes:
230230
</tr>
231231
<tr>
232232
<td><b>Data Type</b></td>
233-
<td>Refers to the kind of value it holds, such as a string, boolean or date-time.</td>
233+
<td>Refers to the kind of value it holds, such as a string, boolean or date.</td>
234234
</tr>
235235
<tr>
236236
<td><b>Multi Valued</b></td>
@@ -272,8 +272,10 @@ To configure properties of user attributes:
272272
- **Integer** Whole numbers (for example `1`, `42`, `-7`).
273273
- **Decimal** Numbers that include decimals (for example `3.14`, `-0.5`).
274274
- **Boolean** A true or false value.
275-
- **DateTime** A date and time value.
276275
- **Object** A structured object that can include multiple sub-attributes.
276+
- **Date** Calendar date without time. Use ISO 8601 `YYYY-MM-DD` (for example `2025-10-01`).
277+
- **DateTime** Date and time with timezone. Use ISO 8601 `YYYY-MM-DDTHH:mm:ssZ` or offset `YYYY-MM-DDTHH:mm:ss±HH:mm` (for example `2025-10-01T14:30:00+05:30`).
278+
- **Epoch** Unix time since 1970-01-01 UTC. Use seconds or milliseconds as integers (for example `1730399400` or `1730399400000`).
277279

278280
Options Data Type
279281

@@ -327,12 +329,23 @@ To configure properties of user attributes:
327329
<td>Text Input, Number Picker</td>
328330
</tr>
329331
<tr>
330-
<td><b>DateTime</b></td>
331-
<td>Text Input, Date Picker</td>
332+
<td><b>Date</b></td>
333+
<td>Text Input, Date Picker. Store dates in ISO 8601 `YYYY-MM-DD`. If the existing value uses another format, render a Text Input.</td>
332334
</tr>
333335
</tbody>
334336
</table>
335337

338+
Once a data type and input format are configured for an attribute, it will be rendered in the corresponding format across all relevant UIs — including the **Console user profile**, **Console user creation wizard**, and the **Self-service portal user profile**. For example, if **Options** is selected with the **Dropdown** input format, the attribute will appear as a dropdown field in each of these UIs.
339+
340+
- Console user creation wizard
341+
![User creation wizard - dropdown input]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-input-format-user-add-view.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
342+
343+
- Console user profile
344+
![User creation wizard - dropdown input]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-input-format-console-view.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
345+
346+
- Self-service portal user profile
347+
![User creation wizard - dropdown input]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-input-format-self-service-view.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
348+
336349
7. Under **Attribute Configurations**, use the table to configure how attributes are handled for each entity.
337350

338351
![Edit attributes]({{base_path}}/assets/img/guides/organization/attributes/configure-attribute-profiles.png){: width="600" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
@@ -365,7 +378,7 @@ To configure properties of user attributes:
365378
!!! Danger "Warning"
366379
These settings only control how the attributes behave in WSO2-managed UIs (Administrator Console, End-User Profile (i.e. My Account), Self-Registration). They **do not** affect backend or API validation.
367380

368-
If you create a custom end-user profile UI, you can reference these configurations to apply the same rules (Display, Required, Read-only) in your own forms.
381+
If you create a custom end-user profile UI, you can reference these configurations to apply the same rules (Display, Required, Read-only) in your own forms.
369382

370383
!!! note
371384
Using the attribute configurations, you can also configure which attributes are displayed in the user creation form when

0 commit comments

Comments
 (0)